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PREFACE 


This manual describes and illustrates the features provided by the 
PDP-15 Utility program DOSPIP. This utility program operates only 
within the PDP-15 Disk Operating System (DOS) monitor environment. 

In the preparation of this manual it was assumed that the reader 
is familiar with the contents of the "DOS SOFTWARE SYSTEM USERS 
MANUAL" (DEC-15—ODUMA-B-D) and with the general operating procedures 
for the PDP-15 equipment. 


PDP-15 UTILITY PROGRAMS MANUAL 


The PDP-15 Utility Programs manual is comprised of a set of individ¬ 
ual manuals , each of which describes the operation and use of a 
PDP-15 Utility program. The set of manuals which make up the Utility 
Programs manual are listed in an Applications Guide located on the 
following page; the Guide also lists the order number of each manual 
and indicates the currently available monitor systems under which the 
program will operate. Individual utility manuals may be ordered by 
referencing the titles and order numbers specified in the Applica¬ 
tions Guide. 


Technical changes made in this version of the manual are indicated by 
a bar (|) in the appropriate page margin. 
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APPLICATION GUIDE 


PDF-15 UTILITY PROGRAM MANUALS 
PDP-15 Utility Program Manuals and the Application of Each 


Manual 


Applies to Monitor 

Title 

Order Number 
(DEC-15-) 


dos : 

ADV 

B/F 

DDT 

Utility Program 

YWZB-DNl 


/ 

/ 

/ 

CHAIN' & EXECUTE 
Utility Program 

YWZB-DN2 


/ 

/ 

/ 

SGJSN 

ADVANCED Monitor 

YWZB-DN3 



/ 


MTDUMP 

Utility Program 

YWZB-DN4 


/ 

/ 


PATCH 

Utility Program 

UPATA-A-D 


/ 

/ 

/ 

EDIT 

Utility Program 

YWZB-DN6 


/ 

/ 

/ 

UPDATE 

Utility Program 

YWZB-DN7 


/ 


/ 

LINKING LOADER 

YWZB-DN8 


/ 

/ 

/ 

PIP 

ADVANCED Monitor 

YWZB-DN9 



/ 

/ 

SRCCOM 

Utility Program 

YWZB-DN11 


/ 

/ 

/ 

SGEN 

DOS Monitor 

USGNA-A-D 


/ 



PIP 

DOS Monitor 

UPIPA—A—D 


/ 
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SECTION 1 


INTRODUCTION 










1.1 PIP PROGRAM 

Tfie PIP - DOS Utility Program (DOSPIP) enables the system user to per 
form the following major functions via keyboard commands % 

al Interchange information between system peripheral 
I/O devices? the system disk device and peripheral 
I/O devices and between user file areas located on 
the system disk device* 

b) Perform verification and modification procedures 
on information being transferred* 

c) Initialize? list and modify file directories of 
directoried disk and other directoried devices* 

This manual is primarily concerned with disk-oriented operations. 

PIP? however? may be used with all other standard PDP-15 I/O and 
mass storage devices; limitations and differences in operation are 
indicated where applicable. 


1*2 MANUAL ORGANIZATION AND USE 


This manual is intended for users who are familiar with: 

a) the general system operating procedures (i.e., 
use of equipment and system startup procedures); 

b) the elements? structure? and use of the DOS moni¬ 
tor as described in the PDP-15 DOS Software Sys ¬ 
tem Users Manual (DEO15-0DUMA-B-D) 

Introductory information and detailed descriptions of PIP operations 
and their applications are given in Sections 1 through 5* Section 6 
contains quick-reference tables* 
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New users of PIP should familiarize themselves with the contents of 
Sections 1 through 5; thereafter, they need only refer to Section 6 
for concise information* 

DOS terms used in this manual, their acronyms and descriptions, are 
presented in Appendix C. 

1.3 WRITING CONVENTIONS 


Table 1-2 lists a group of commonly used keyboard command and control 
characters together with (a) their functions as recognized by PIP 
and (b) their representations in listing and, in ‘this manual, in 
text and examples* 

1.4 PIP 'STARTUP PROCEDURES 

Once a user has completed the system log-in procedures, PIP may be 
called into core by the entry of the name "PIP". When loaded, PIP 
outputs the following message on the console printers 

$PIP 

DOSPIP Vxxnnn 


followed by a right angle (>) "ready" symbol. (Where xx is the appropriate 
monitor version and nnn is the PIP version.) 


User commands are entered immediately after the ready symbol. Once 
an operation has been initiated, the user must not attempt to make 
any further entries until PIP prints the "ready" symbol. The only 
exception to this is when the user wishes to abort the current opera¬ 
tion; the entry of: 

al CTRL P tiP) aborts the current operation and 
returns control to PIP; 

b) CTRL C (1C) aborts the current operation and 
returns control to the DOS monitor. 
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TABLE 1-2 


ACTUATED 
KEY OR KEY 
COMBINATION 

RUBOUT 

CTRL U 

CTRL P 

CTRL C 

CTRL R 

CTRL D 

SHIFT O 

RETURN 

ALT MODE 


General Keyboard Command Characters 


PRINTED 
RESPONSE & 

TEXT SYMBOLS FUNCTION INITIATED BY ENTRY 


\ 


Response - @ 
Text - fu 

fP 


tc 


Causes deletion of the last 
entered character. 

Causes deletion of the last 
entered line. 

Restarts PIP or continues on 
interrupted input or output 
operations on a non-file oriented 
device. 

Causes control to be returned 
to the Monitor. 


iR Enables processing to be resumed 
when a Device Not Ready (IOPS4) 
error has been corrected. 


iD Terminates input from the con¬ 

sole keyboard. 

Divides PIP command string into 
Output and Input sections (see 
Section 2). 


Non-printing 
(Text symbol is % ) 


Initiates a carriage return/ 
line feed operation. Normally 
used to terminate command strings. 


Non-printing Causes control to be returned 

(Text symbol Is @) to ttie Monitor on completion of 

the current operation. The moni¬ 
tor performs a carriage return/ 
line feed operation and announces 
itself. 






SECTION 2 


COMMAND STRING FORMATS AND BASIC OPERATIONS 


Tills Section describes the basic PIP command string formats and the 
elements which comprise them* Included are lists and descriptions 
of the operations provided the user by PIP * 

2*1 PIP COMMAND STRING, GENERAL DESCRIPTION 


O'- 





PIP command strings are limited to a maximum of 72 characters, a 
single console device input line and no provision is made for com¬ 
mand string continuation lines. The items which may be specified 
in a PIP command string ares 


Item 


11 Primary operation to 
be performed 


21 Any storage or I/O 
device (s} involved 


3) The names of any 
files involved 


4} Optional Functions 

(i«e» ? Data Modes and/or 
secondary operations) 
to be Included 


51 Optionally defined 
Protection codes 


How Specified 

Identified by an assigned single alpha¬ 
betic character (e.g. , T for Transfer)* 
Refer to Table 2—3 for a description 
of each Primary Operation and its com¬ 
mand character. 

Identified by an assigned 2 or 3- 
character alphanumeric mnemonic (e.g., 
DT for DECtape). Refer to Table 2-2 
for a listing of the standard DOS sys¬ 
tem storage devices and the mnemonic 
assigned to each. 

Identified by an assigned (user or 
system) 6-character filename plus a 
3-character extension. Refer to the 
DOS Software System User’s Manual 
dec^is^oduma^b^d for descriptions of 
filenaming considerations. 

Identified by an assigned alphabetic 
character enclosed in parentheses 
e.g. f (A). Refer to Table 2-4 for 
a description of each optional function 
and its assigned command character. 

One or more functions may be specified 
e.g. , (A) or (AN). 

Identified by a numeric normally en¬ 
closed in parentheses; only one code 
may be specified in a command. If an 
optional function is specified, the 
protection code and command character (s) 
should be placed within the same set 
of parentheses (e.g., (1) or (Al)). 

Refer to paragraph 2.3.7 for a descrip¬ 
tion of protection codes. 
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Item 


6>i Required User File 
Directory (UFD). 
Identification 


How Specified 

UFD *s in commands are identified by 
their assigned 3-character mnemonic 
(UIC) enclosed within angle brackets 
(e.g M < ABC>) ; refer to paragraph 
2« 3 » 5 for a detailed description. 


2 * 2 TYPES OF PIP COMMANDS 


There are two basic types of PIP commands: 


al Destination/Source commands, and 


bi Single-Device commands. 


These command categories are described, individually, in paragraphs 
2.2,1 and 2.2„2. 

2„2ol Destination/Source Commands 

Commands of this type are used to specify PIP operations which in¬ 
volve the transfer of data between two devices or device areas. 

Such commands consist of two sections separated by a delimiters 

[DESTINATION] ^ [SOURCE] 


The elements within these sections specify where the data to be trans¬ 
ferred is to be found [SOURCE] and where it is to go [DESTINATION]. 

The major operation to be performed is always the first character in 
any PIP command string? optional operations may be specified in 
either section of this type of command. For example, in the follow¬ 
ing command string: 

>T M DK t _pESTFL u SRC^DTl | _ J FILEA u SRC ) 

the destination section consists of: 

[T u DK U DESTFL U SRC] . 

The elements of this section specify: 

al T = a Transfer operation is to be performed 
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BL DK 


tils disk, device is to receive the Transferred 
data 


c) 


NOTE 


When disk is specified, it 
represents the current UFD. 

DESTFLj_£RC = the name of the disk file into 
ferred data is to be written. 


which the Trans- 


The SOURCE section of the above command string consists of: 









iDTl^jFILEAjJESRC] 

The elements of this section specify: 

al DTI = the data to be transferred resides on the tape 
mounted on DECtape Unit #1 

b) FILEA SRC = the name of the DTI file which contains 
the data to be transferred. 

Figure 2-1 illustrates the format of the most complex form of the 
destination/source type of command string. This figure also lists: 

a) the PIP operations which require the format illustrated, 
bl permitted device mnemonics, 
cl permitted switch options. 

2.2.2 Single-Device Commands 

Commands of this type are used to specify PIP operations which in¬ 
volve only a single device and a file or set of files. Such a com¬ 
mand must specify the operation to be performed and the device in¬ 
volved. Where needed, file names and option switches may also be 
added to the command string. For example, the command: 

>D u DTl L /ILEA l _^RC ) 
specifies that: 

al a delete CD) operation is to be performed, 

bl the device containing the item to be deleted is 
DECtape Unit #1 (DTI), 

c) the item to be deleted is file FILEA SRC. 


2-3 




T LJ DK 


DESTFL i —i SRC '—> (G) 


DTn 


DATA __j SRC ) 


OPERATION 

COMMAND DESTINATION 
CHARACTER LJ DEVICE 


T = Transfer file 
L = List directory 
C = Copy mass 
storage 

R = Rename file 
B = Block copy 


DESTINATION FILE OPTION ^SOURCE 
LJ (filename LJ ext) LJ SWITCH (S)^ ^ DEVICE LJ 


SOURCE FILE 

(filename I I ext) 


Optional for non¬ 
file oriented de¬ 
vices. use 
commas to sepa¬ 
rate multiple 
file names and 
extensions 


Use commas to 
separate mul¬ 
tiple file 
.names and ex¬ 
tensions . 


PP = Paper tape punch 
DTn= DECtape unit 
T’l' = Teletype 
LP = Line printer 
MTn- Magtape 


PR = Paper tape reader 
TT = Teletype 
CD = Card reader 
DTn= DECtape unit 
MTn= Magtape unit 


DK = DECdisk 
VP = VP15A CRT display 
DPn= Diskpack unit 
RKn= Disk cartridge unit 


DK = DECdisk 

DPn= Diskpack unit. 

RKn= Disk cartridge unit 


TERMINATOR 


J= Return 
control 
to PIP 
ALTMODE « 
Return 
control 
to the 
monitor 


Data Mode Switches 


Function 


Switches 


A = IOPS ASCII 
B = IOPS Binary 
I = Image Alpha¬ 
numeric 

H = Image Binary 
D = Dump 


E - Convert tabs to spaces 
G = Flag bad parity lines 
C = Convert multiple spaces to 
tabs 

W = Combine files 
Y = Segment files 
N = New Directory 
Snn = New directory with CTRL Q 
area. Size of area (nn) = 

8, 12, 16, 20, 24, 28, or 32 
(K words) N operation only. 

Default = current size of 
system. 

F = Insert Form Feed every 55, n 
lines or after .EJECT 

T = Delete trailing spaces Hi Input must be 

Q = Delete sequence numbers j card^oraat 
M = Request a listing of 
the system MFD 

L = Request a listing of the 
system SYSBLK directory 
P = Request UFD listing with 
RIB data 


Figure 2-1 Destinatiory^Source Command String Format 
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Figure 2-2 illustrates the format of the most complex form of a Single- 
Device PIP command,. Also listed in Figure 2-2 ares 


a} the operations which require the illustrated format, 
b] permitted device mnemonics, 
cl permitted switch options„ 






V 


DT£ l_J FI LEA/FI LEB ,l_j (a) ^ 


OPERATION 

COMMAND DEVICE 

CHARACTER I-J MNEMONIC 


N = New directory 
V = Verify file 
D = Delete 
I = Initialize 
U = Update 


file(s) involved 

Filename > f Ext, 


Use commas to separate 
multiple filenames and 
extensions. 


OPTION 

switch(es) 


terminator 


j ^Return control 
to PIP 

ALT MODE = 
Return control 
to Monitor 


PR = Paper Tape Reader 
DTn = DECtape unit 
DK = DECdisk 
DPn = Diskpack unit 
MTn = Magtape unit 
RKn = Disk cartridge unit 


A = IOPS ASCII Data mode 
B = IOPS Binary Data mode 
S = New directory with a 
core-sized tQAREA. 

Snn = New directory with a 

user-specified fQAREA* 
K = delete UFD. 

X = delete all truncated 
files. 



Figure 2-2. PIP Single Device Commands, General Format 
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2.3 COMMAND STRING ELEMENTS 

The basic elements which comprise the PIP command strings (i.e. ? de¬ 
limiters , mnemonics , format requirements , etc.) are described in the 
following paragraphs. Also described are the major user capabilities 
offered by PIP? sub-functions which may be carried out within the 
context of major PIP operations? and how UFD’s? data modes and pro¬ 
tection codes are specified in PIP commands. 

2.3.1 Command String Delimiters 

Delimiters are flags which are set to separate elements of a command 
string. The delimiters used in PIP commands are listed and their 
uses described in the following table. 

TABLE 2-1 Command String Delimiters 


Use Delimiters 


To 


In This Manners 


u 


(space) 


•*- (back 
arrow) 


(colon) 


(comma) 


Separate major command string 
elements 

Separate destination and 
source sections* of a command 
string 


t lP k lF ile « * • 

dest. 4- source 
TJDK+-DT1JFILEAJ3RC 


a) 

In RENAME command? sepa¬ 
rates UFD name from speci¬ 
fied UFD protection code 

< JAN: 0 > 

b ) 

Separate device mnemonic 
and filename 

DTIsFILEA 

a) 

Separate filenames within 
a command string list 

DTi_jFILEA?FILEB?FILEC 

b) 

Specify number of tapes 
or files involved in an 

PRun (READ 3 tapes) 


operation when names are 
not needed 



( ) 


(semicolon) 


(angle 
brackets) 

(paren¬ 
theses ) 

(dash) 


Separate filename and file¬ 
name extension or data mode 
option 

Identify non-current UFDs 


Identify option switches or 
specified protection codes 

Separator to indicate a 
range of numbers 


DTIiFILEA?FILES ;SRC 


< JOE> 


(A) 

100-150 
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2*3*2 Standard DOS I/O and Storage Devices 

The I/O and storage devices for which the DOS Monitor contains inter¬ 
facing software are listed, together with their required command 
mnemonics, in the following tables 


TABLE 2—2 PIP Command Device Mnemonics 


Peripheral Device 


Required Mnemonic 


DECdisk (RF15) 
Diskpack (KP02) 

Disk cartridge (RK05) 

DECtape 

Magnetic tape 

Teletype 

Line Printer 

Card Reader 

Paper Tape Reader 

Paper Tape Punch 

Storage Tube Display 


DK 

DPn 

RKn 

DTn 

MTn 

TT 

LP 

CD 

PR 

PP 

VP 


NOTE 

The letter n in the above table indicates 
"unit number"* For example, DECtape unit 
#1/1 a system is specified as DTI * If no 
unit number is specified in the mnemonic 
for a multi-unit device, the numeric 0 is 
assumed* For example, the mnemonic DP is 
equivalent to DP0 a 


2 * 3 a 3 Primary Operations 


TRe major capabilities provided by PIP are referred to as primary 
operations. Transfer, the user -directed interchange of files between 
storage devices, and List, the printing of user-specified user and 
monitor directories, are two examples of PIP primary operations. 

In a PIP command, the primary operation is identified by a single 
alphabetic letter entered as the first character of the command 
string. For example, in the command: 

>T U DK^DT1 U FILEA U SRC ) 

the letter "T" specifies the transfer operation (i.e., FILEA SRC 
is to be transferred from DTI to the current UFD on (DK). 

All PIP primary operations are listed and described briefly in 
Table 2-3. 
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TABLE 2-3 


PIP Primary Operations, Summary 


The Primarys is identified 
by the 

OPERATION COMMAND CHARACTER 


and performs the 
FUNCTION 


TRANSFER T 

VERIFY V 

SEGMENT S 

LXST L 

NEW DIRECTORY N 

DELETE FILE D 

RENAME R 

COPY, Mass Storage C 

BLOCK COPY B 


INITIALIZE I 


UPDATE U 


Transfer named data files between 
peripheral I/O devices. 

Check a named file for parity or 
checksum errors - 

Divide a file into a specified 
number of segments (16 maximum) and 
store each segment as a separate 
named file. 

Provide listings of system direc¬ 
tories . 

Either clear an existing directory 
or, if one does not exist, estab¬ 
lish a new one. 

Delete files from User File Direc¬ 
tories . 

Rename files and change protection 
codes for the file or the UFD in 
which it is listed* 

Copy the contents of one mass 
storage medium onto another. 

Copy the contents of one or more 
selected data storage blocks con¬ 
tained by one device onto another 
medium. Block copy to the disk may 
be performed, only by tdie MIC user. 

Enable the system manager to clear 
all disk bit maps and restore the 
MFD to its original state. This 
command may be used only by the 
MIC user* 

Update the monitor's Bad Allocation 
Table (BAT) and Storage Allocation 
Table (SAT) whenever defective stor 
age blocks are detected on the disk 
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2.3.4 Optional Functions 


PIP primary operations may be executed alone or they may include 
one or more "optional functions". 

it is used to specify parameters (such as data modes) and secondary 
operations (such as parity checks) which are to be carried out 
during the execution of the primary operation. An optional function 
is identified by an alphabetic letter enclosed in parentheses which 
1S entered as a switch in a PIP command. Switch (A) which specifies 
that IOPS ASCII data is to be handled in the performance of the 
primary operation and switch (Y) which indicates that a file segmen¬ 
tation operation is to be performed during the primary operation 
are two examples of optional functions and their switches. The 
use of switch (A) in the following command: 

>T,J)K-*-DTl u FILEA u (A) ) 


specifies that the data contained by FILEA is in IOPS ASCII form. 
All PIP optional functions are listed and described in Table 2-4. 


OPTION 

IOPS ASCII 
Data Mode 


TABLE 2-4 PIP Optional Functions 
COMMAND 

CHARACTER FUNCTION 

(A) I 


TOPS Binary 

(B) 

linage Alphanumeric 

CD 

Dump 

CD) 

Image Binary 

CH) - 

Bad Parity & 
Checksum Check 
& Correction 

(G) 

Tab to Space 
Conversion 

CE) 

Convert Multiple 
Spaces to Tabs 

CC) 


Specifies the type of data 
(i.e., format) handled by 
the primary PIP operation. 


Outputs error messages and the 
lines containing errors detected. 
Corrective actions are permitted. 

Causes all tabs found in the 
data handled to be expanded in¬ 
to a series of spaces. 

Causes each group of two or more 
spaces encountered during the 
primary operation to be contracted 
to a TAB. 




TABLE 2-4 PIP Optional Functions (Cont’d) 


COMMAND 

OPTXON CHARACTER FUNCTION 


Segment Files 

(Y) 

Indicates that the file being 
transferred is to be segmented. 

Combine Files 

CW) 

Combines two or more separate 
files into a single file. 

Form Feed 

(F) 

Causes a form-feed and a RETURN 
character to be inserted after 
the detection of each .EJECT 
statement or after every 55 in 
lines. 

Delete Trailing 
Spaces 

(T) 

Causes all trailing spaces to be 
deleted from alphanumeric data being 
handled during the primary operation. 

Delete Sequence 
Numbers 

(Q) 

Used for punched card input, this 
option causes all input sequence 
numbers to be deleted. 

Reserve QAREA with 
New Directory 

(Snn) 

Used for DECtape devices only, this 
option initializes any existing di¬ 
rectory or establishes a new direc¬ 
tory, and causes a CTRL Q area to 
be allocated on the device. The 
size of the allocated area may be 
specified (i.e., nn) by the user. 

New Directory 

CN) 

Performs the same function as the N 
primary operation. It either clears 
an existing directory or, if one 
does not exist, establishes a new one 

List MFD 

(.Ml 

Enables standard UIC users to ob¬ 
tain a listing of all unprotected 

UFD *s contained by the device (disk). 
The MIC user will obtain a listing 
of all UFD 1 s contained by the device. 

List SYSBLK 

CL) 

Enables the user to obtain a list¬ 
ing of the system SYSBLK directory. 

List UFD with 
Auxiliary Data 

(P) 

Causes file RIB data to be added 
to a UFD listing. 

Delete UFD 

CK) 

Removes UFD entry from MFD„ 

Delete All 
Truncated 

Files 

Cx) 

Causes all truncated files contained 
by the current or specified UFD to 
be deleted. 
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2.3.5 Specifying UFD 8 s 


Whenever a UFD which is not current is referenced in a PIP command 
strings 


al its UIC (identifying code) written within angle 
bracket delimiters (e»g«^ <xxx>) must be added 
to the command. 

bl the UIC must be inserted immediately after the 
mnemonic representing the device on which its 
UFD resides. 


For example, the commands 


>T U DK u < JAN>^DT1 u FILEA u SRC ) 

specifies that FILEA SRC on DECtape unit #1 is to be transferred to 
the non-current UFD "JAN” located on the disk device. 


2.3.6 Specifying Data Modes 1 


PIP operations which involve the interchange of data require that 
the form of the data being handled (Ue., its data mode) be indi¬ 
cated in the initiating command string. 

Data modes in PIP are specified either by the filename extension 
of the file being transferred or by an equivalent data mode option 
switch. The Data Mode indicators recognized by PIP are listed 
in the following table (Table 2-5)* 

The available PIP data mode switches and their uses ares 


a. (A) IOPS ASCII Switch - Files containing data in 
IOPS ASCII form require the use of the PIP (A) 
data mode switch. ASCII files are identified by 
the extensions § 1) SRC or 

2) a S^character extension where the 
third character is numeric (e.g^ 
004) . 


(B) IOPS Binary Switch - Files containing data in IOPS 
Binary form must be handled using the (B) switch. The 
filename extension BIN is used to identify binary files. 


1 Refer to DOS Software System Users Manual, DEC'-IS-ODUMA-B-D for de^ 
tailed descriptions of data modes. 




I 


c® (I) Image Alphanumeric Switch - The (I) switch is re¬ 
quired during transfer of Image Alphanumeric Files 
and* as the name Image implies, maintains the File data 
in its exact form as read from the source file® The (I) 
switch must specifically be used when copies of paper 
tapes In either HRM or RIM hardware reader modes (MACRO-15 
®ABS or a FULL paper tape) are required®. 

d® (H) Image Binary Switch - Binary files (extension BIN) 

to be maintained in their exact form must be transferred 
using the (H) data mode switch® 

e® (D) Dump Mode Switch - Files containing data in an 
absolute binary form (extension ABS) must be handled 
using the (D) mode switch® 


The specific combinations of data mode switches and optional function 
switches which are permitted in each of the PIP primary operations are 
given in Section 3 * 


TABLE 2-5 Data Modes and Data Mode Indicators 


DATA MODES 




IOPS 

IOPS 

IMAGE ALPHA/ 

IMAGE 



ASCII 

BINARY 

DUMP NUMERIC 

BINARY 

FILENAME 

SRC 

/ 




BIN 


/ 



EXTENSIONS 

ABS 



/ 



Numeric 

/ 





(A) 

/ 





IB) 


/ 



OPTION 

•(D) 



/ 


SWITCHES 

(I) 



/ 



(H) 




/ 
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DATA MODE SWITCHES VS 


FILENAME EXTENSIONS 


From the above table it can be seen that switch options (A), (B) and 
(D) specify the same data modes as filename extensions SRC, BIN, and 
ABS. Only one data mode indicator is needed in a command string; 
if the filename extension is given, its corresponding data mode 
switch is not required; conversely, the extension is not needed if 
the switch is given. To illustrate; 


THE COMMAND: 

a) T U DK U FILEA^DT2 1 JDLDFIL U SRC ) 

b) TJDK t /ILEA-<-DT2jDLDFIL u BIN^ 

c) T 1 _pK l _piLEA^DT2jDLDFIL u a.BS ) 

2.3.7 PIP UFD and File Protection 


IS EQUIVALENT TO: 

a) T J>K o FILEA+DT2 u 0LDFIL u (A )) 

b) T,JDK U FILEA^DT2 U 0LDFIL U (B) ^ 
C) T u DK l /ILEA^DT2 1 J3LDFIL u (D)P 

Codes 


In performing PIP operations which involve User Directories and/or the 
files which they contain, the user irust be aware of the UFD and file 
protection codes involved„ These codes determine the accessibility 
of the UFD J s and of the files which they contain. 

New protection codes may be assigned by the user or, by default, by 
the system® Existing codes may be modified using PIP command R e 
(refer to Section 3)* 


UFD*s may be assigned the following codes: 


DIRECTORY PROTECTION CODES 

0 unprotected: any user may access, manipulate 

the contents, and delete an un¬ 
protected UFD ® 


protected: only the user logged in under 

the UIC of the UFD (or the MIC) 
may write into a protected UFD„ 


NOTE 

The DEFAULT value for UFD directory protection 
codes is always 1„ 



Files may be assigned any of the following protection codess 


FILE PROTECTION CODES 



PERMITTED 

OPERATIONS 


CODE 

RE AD 

WRITE 

PROTECTION GIVEN 

1 

yes 

yes 

unprotected 

2 

yes 

no 

write protected 

3 

no 

no 

protected 

none 

r? -? \7an 

SYSTEM 

DEFAULT VALUE 1 



NOTE 

File protection codes are valid only when the 
UFD in which they are located is protected 
(code 1) «, 


1 The system default value for file protection codes is set by the 
system manager (MIC) during the initial configuration of the system 
(i.e M system generation) . 
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SECTION 3 


PIP OPERATIONS, DETAILED DESCRIPTIONS AND EXAMPLES OF USE 


3 * 1 INTRODUCTION 

This Section contains descriptions of the PIP operations which may 
be performed by the standard (UIC) DOS system user. The PIP opera- 
tions unique to the system manager (MIC) are described in Section 4* 




3.2 N: DIRECTORY SETUP OR INITIALIZATION OPERATION 
The New Directory, N, operation permits the user to: 


a) create a new UFD for the currently logged-in UIC 
or a specified UIC, 

b) initialize an established UFD for the current UIC 
or a specified UIC, 

c) initialize and change the protection code of the 
UFD for the current or a specified UIC, 

d) delete the UFD of the current or a specified UIC 
from the system (i.e., remove its name from the 
MFD) , 

e) initialize the directories of peripheral file- 
structured mass storage devices 1 . 


WARNING 

Each, time the N command is used, all of the 

files on the directory involved are DELETED. 
Care must be taken to ensure that needed files 
are not lost. 


Each of the above functions and the command format required for its 
execution are described in paragraphs 3.2.1 through 3.2.5. 


3.2.1 Create/Initialize Current UFD 


The command: 


> 


NljDk; 


1 Utility program MTDUMP must be used to initialize directories on Mag¬ 
tape units (MTn). Refer to manual DEC-15-YWZB-DN4 for a description 
of MTDUMP and its use. 
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is used either to: 


a) establish a User File Directory (UFD) for the current 
UIC, or 

bl initialize (delete all files from) an existing UFD set 
up for the current UIC * 

For example, if the current UIC is "GEP" the new or initialized UFD 
resulting from the above command has the format: 

15-JUL-71 

DIRECTORY LISTING (GEP) 

1147 FT? EE BLKS 
0 USER FILES 
0 USER BLKS 

UFD 1 s set up or initialized using the basic N command (i.e., N DK J ) 
are automatically assigned a default protection code of 1 (write 
operation permitted only to the current UIC)* 

The current UIC can use the basic N command to set up UFD * s under 
other UIC codes by specifying another UIC in the N command. For 
example, the current UIC "JAN" can set up a UFD under the UIC "ABC" 
with the command: 

> N u DK u <AB c >) 

UFD 1 s set up in the above manner are automatically assigned a protec¬ 
tion code of 0 (unprotected)» 

Any unprotected UFD located on the disk being accessed may be initial¬ 
ized by the current user if he knows and specifies its UIC. For 
example, an unprotected UFD with a UIC of "SCR" is initialized by 
the command: 

>N U DK U <SCR> ) 

3.2.2 Setting up the UFD Protection Code 

UFD protection codes may be specified in the N command to: 

a) set a desired protection code for a new current or 
specified UFD, 

b) change the protection code of an existing UFD. 


3-2 



The command formats used for these functions ares 


a) >N U DK U (X)) for current UIC UFD. 

b) >N (J DK t <: AAA> W (X) ) for specified UFD's. 


wheres 

(X) represents the desired protection code 

<AAA> represents the specified UIC. 


The UFD protection codes ares 


1 protected write operations only permitted 

by the UIC or the system MIC* 

0 unprotected read/write operations permitted 

to all userso 


The following are examples of the uses of the above N command formatss 


a* The commands 


>NJDK u (0)^ 


creates or initializes the current UFD with a direc¬ 
tory protection code of 0 (unprotected)* 


b«, The commands 


>NJDK t J ABC> U (1)) 


creates Cor initializes) the UFD "ABC" with a speci¬ 
fied protection code of 1 (protected) ® Remember * 
if this type of command is used, the current user 
cannot access the specified UFD since it will be 
protected„ 


NOTE 

DO NOT use the N command to change the 
protection code of an existing UFD un¬ 
less the UFD is to be initialized (all 
files deleted)„ 


3.2.3 Deletion of UFD's 



The PIP N command permits the user to delete the UFD of the current 
UIC and specified unprotected (code 0 ) UFD's from the system (i.e„, 
remove their names from the MFD). 
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The ^delete 1 * function is set up by the addition of the "K ,T func¬ 
tion switch to the basic' N command , as follows: 


a) >N u DK la (K) } deletes the UFD of the current UIC 

bl >N L J3K Lt <: XXX> U (K) ) deletes the UFD of a specified UIC 

(< XXX>) 

For example, assume the following Master File Directory (MFD) as 
being current: 


10-AUG-71 - 

MFD DIRECTORY LISTING 
5753 FREE BLKS — 


47 USER FILES 
612 USER BLKS 
ABL NON(0) 

XYZ NON(0) 

\ \ 



UFD UIC r s UFD protection code 


Current date 

Number of free device blocks 
Number of user files on device 
Number of device blocks occupied 
by files 

Entries of Unprotected UFD f s 


NOTE 

Listings of the current MFD as shown above 
are obtained using the PIP List (L) operation. 


The commands: 


>N 1 _flK u < ABL> U (K) ) 

>N U DK Lf XYZ> a (K) ) 

delete the unprotected and non-current UFD 1 s ABL and XYZ from the disk. 
Their deletion is illustrated by the resultant MFD: 

10-AUG-71 

NFP DIRECTORY LISTING 
5753 FREE BLKS 
47 USER FILES 
R12 USER BLKS 

3.2.4 Initialization of DECtape Directories 

The directories of DECtape storage devices may also be initialized 
using the N command. The command format is: 

>N device mnemonic and unit number J 

For example, the command: 

>N uP T1 ) 

Initializes the directory of the tape mounted on DECtape unit 1. 



NOTE 


When a DECtape is initialized* the tape 8 s File 
Bit Map blocks are cleared and the Directory 
Block is set up to indicate that only the File 
Bit Map and Directory Blocks are occupied. 


3 - 2 o 5 (S) Switch? Setting up DECtape Directories with IQ Areas 


The optional function switch (S) added to DECtape N commands both 
initializes the device directory and causes a CTRL Q area (f QAREA) 
to be reserved on the DECtape for core tQ-dump operations * The (S) 
switch is the only switch permitted in N DECtape commands. The 
basic command format is t 


>N t jlevice mnemonic & unit number u (S) ) 


The (S) switch used? 


a) alone indicates that the size of the reserved 

iQAREA should be the same as the current 
system core size. For example* the com¬ 
mand ; 

>N U DT1 U (S)^ 

in a system running in 16K of core estab¬ 
lishes a 16K IQAREA (word locations) on 
the tape mounted on DECtape unit #1. 

b) with a one or two digit number (i.e.* (Snn))* 

specifies the size of the +QAREA to be 
reserved on the tape mounted on the DEC¬ 
tape unit. 

For example* the command? 

>N U DT1JS16)J 

causes a tQAREA* 16K in size* to be 
reserved on the tape mounted on DEC¬ 
tape unit #1. 


3.3 L: DIRECTORY LIST OPERATION 


The List* L* operation enables the user to obtain copies of both disk 
and DECtape directories in? 


a) punched tape form* 

b) printed form* or 

c) as a CRT display. 






Copies of directories which contain only selected file entries may 
also be obtained. 

The basic command format used in L operations is : 

>L u lis ting device^s ource device^ 


where. 

a) the listing device may be the: 

1) console teleprinter (TT) 

21 line printer (LP) 

31 paper tape punch (PP) 

41 optional CRT display devices (refer to 
Appendix A) 

b) the source device may be any file-structured 
mass storage device within the system (i.e., 

DK, RKn f DTn, DPn 1 ) . 

Three optional switches may be used within an L command; they ares 

a) CM), list Monitor MFD table 

b) (L), list Monitor SYSBLK table 

c) (P) , used only in UFD list operations, this switch 

causes additional file protection and file 
storage information to be included in the 
reguested listing. 

Tfie various list operations which may be performed, the required L 

commands for each, and examples of the listings obtained are de¬ 
scribed in paragraphs 3.3.1 through 3.3.6. 

3.3.1 List UFD for Current or Specified UIC 

The UFD for a current UIC located on a disk device may be listed 
using the basic L command format. 


For example, assuming a current UIC of "GEP", the command: 


>L,_ t LP- < -DK ) 


1 Utility program MTDUMP must be used to list Magtape directories 
(refer to DEC-15—YWZB-DN4). 


3-6 



produces a printout of the UFD with a format similar to the follow¬ 
ing: 


15-JUL-71 ——- 

DIRECTORY LISTING (GEP)- 

1131 FREE BLKS - 

3 USER FILES - 

6 USER BLKS - 


PART A 

SRC 

1 

15-JUL-71 

PARTB 

SRC 

2 

15-JUL-71 

PARTC 

SRC 

3 

15-JUL-71 



CURRENT DATE 

DIRECTORY IDENTIFICATION CODE (UIC) 

NUMBER OF FREE BLOCKS ON TEE DEVICE 
NUMBER OF USER FILES CONTAINED BY THE UFD 
NUMBER OF DEVICE BLOCKS OCCUPIED BY 
THE UFD FILES 

- DIRECTORY USER FILE ENTRIES 


DATE USER FILE WAS ENTERED INTO UFD 


NUMBER OF DEVICE BLOCKS OCCUPIED BY FILE 
■ FILE FILENAME AND EXTENSION 


The current user may also obtain a listing of any unprotected UFD 
in the system by specifying its identifying UIC in the L command. 
For example, the command: 

>L U LP^DK U < JAN> ) 


causes the printout of the unprotected disk UFD identified by the 
UIC "JAN". 

3.3.2 (M) Switch: List MFD 


A listing of a disk Master File Directory (MFD) may be obtained 
by the addition of the (M) switch to the L command. For example, 
a line printer listing of a DECdisk MFD is produced by the 
command: 


>L tJ LP^DK lJ (M) ) 


The listing produced would have a format similar to the following: 


15-JUL-71- 

MFD DIRECTORY LISTING 

1147 FREE BLKS - 

52 USER FILES - 

ISIS USER BLKS - 

TUK 1003(0) 6 

PIP 2532(0) 1 


114 



CURRENT DATE 

NUMBER OF FREE BLOCKS ON THE DEVICE 
NUMBER OF USER FILES ON THE DEVICE 
NUMBER OF DEVICE BLOCKS OCCUPIED BY USER 
FILES 

USER FILE DIRECTORIES 


NUMBER OF DEVICE BLOCKS OCCUPIED BY 
SPECIFIED UFD FILES 

NUMBER OF FILES CONTAINED BY THE SPECIFIED UFD 
FILE PROTECTION CODE 

-NUMBER OF FIRST DEVICE BLOCK OCCUPIED BY UFD 
UFD IDENTIFIER (UIC under whicTi it was created) 
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NOTE 


MFD listings obtained by standard users (UIC f s) 
list only the unprotected UFD entries. Only 
the system manager (MIC) can obtain a complete 
list of both protected and unprotected UFD B s* 


3-3•3 (L) Switch? List Monitor SYSBLK 


The addition of the (L) switch to a list command made to the disk 
device containing the operating system results in a printout of the 
system block (J3YSBLK) table on the selected listing device. For 
example, assuming a DK system device, the command 

>L u LP^-DK ul CL) ) 


produces a listing of tie system SYSBLK on the system line printer ; 
with a format and contents similar to the following: 


x 


PROGRAM NAME 


SYSBLK 

LISTING 




NAME 

EB 

NB 

FA 

PS 

.SYSLD 

0 

40 

100 

17400 

DO S 1 5 

40 

33 

1352 

14526 

tQAREA 

101 

200 

5 

77773 

BOSS 15 

301 

16 

1241 1 

71640 

EDIT 

317 

15 

12001 

563 6 

EDI T VP 

334 

17 

10277 

7340 

EDITVT 

353 

17 

10302 

7335 

PIP 

372 

35 

1526 

16111 

QFILE 

427 

2 

1 7041 

437 

MACRO 

431 

33 

2630 

1 5005 

GREF 

464 

5 

1 5450 

2137 

CHAIN 

471 

21 

7600 

10037 

P4 

512 

35 

2176 

15441 

DUMP 

547 

5 

1 5300 

2337 

DTCOPY 

554 

3 

16662 

755 

PATCH 

557 

10 

12700 

3453 

UPDATE 

567 

13 

12370 

52 47 

SRCCOM 

602 

13 

12674 

4743 

5 TR A N 

615 

1 1 

13607 

4030 

8STRAN 

626 

1 1 

13562 

4055 

MTDUMP 

63 7 

12 

13167 

4450 

SGEN 

651 

3 5 

5740 

10163 

TKB 

70S 

21 

7573 

10044 


Number of 
blocks 
allotted 
to program 


Number of 
first device 
block oc¬ 
cupied by 
program 




SA 

0 

1742 

0 

54020 
12002 
10551 
10553 
1671 
17045 
2630 
1 5451 
7600 
2323 
1 5300 
1 6701 
12700 
12371 
12777 
13671 
13644 
13260 
6004 
7750 


First core 
address oc¬ 
cupied when 
program is 
loaded 


Program size, 
number of 
word locations 

X 


Program 

starting 

address 
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STSBLK supplies a complete listing of the language and utility pro¬ 
grams contained by the system; the names listed in SYSBLK are the 
keyboard commands required to call (i„e., load) the listed program 
into core. 

3*3*4 CPI Switch. List UFB with File Protection Codes and RIB 1 

Pointers 

The optional switch (P) added to an L command causes file protection 
code, file starting block number, and RIB date to be added to each 
file entry contained by the UFD. For example, assuming the UIC "JAN" 
to be current, the commands 

>L U LP^-DK ) 


produces the following printout: 


1 5-JUL-71 ———— — ——- CURRENT DATE 

DIRECTORY LISTING CJAN)-- UFD IDENTIFIER 

1 125 FREE BLKS -----—- FREE DEVICE BLOCKS 

1 USER FILES — — - . NUMBER OF USER FILES 

2 USER BLKS — NUMBER OF USER FILE DEVICE BLOCKS 

CRDFL BIN 2 15-JUL-71 —— USER FILE ENTRY 


To illustrate the use of the (P) switch, the commands 


>L U LP^-DK U (P)^ 

produces the following printout: 


NOTE 






Only the information added by the (P) option 
Is indicated* 


15-JUL-71 

DIRECTORY LISTING CJAN) 
1125 FREE BLKS 
1 USER FILES 


CRDFL 


USER BLKS 
BIN 2553 C 2) 



1 5-J UL-71 


z 


2552 

j 


z 


POINTER TO THE FIRST RIB WORD IN BLOCK 


POINTER TO DEVICE BLOCK CONTAINING FILE RIB 
TABLE 


CURRENT FILE PROTECTION CODE 
•FIRST BLOCK OF FILE 


1 Retrieval Information Block, contains pointers to the non-contiguous 
file storage blocks (refer to the DOS— 15 Users Manual , DEC -1 5 —ODUMA—B— D g 
for a complete description of this table)* 
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3 a 3o5 List DECtape Directories 


The directory of any DECtape storage device within a system can be 
listed using the basic L commando For example, the commands 


>L u TT-tDTl} 

causes the directory of the tape mounted on DECtape Unit #1 to be 
listed on the console printer,, Directory listings have a format 
similar to that of the following example: 


17-SEP-71 


DIRECTORY LIFTING 
1062 FREE BLKS — 
USER FILES - 
SYSTEM BLKS 




CURRENT DATE 

NUMBER OF FREE BLOCKS ON DECTAPE 
NUMBER OF USER FILES ON DECTAPE 
NUMBER OF DECTAPE BLOCKS OCCUPIED 
BY DIRECTORY AND FILE MAPS (also 
by Monitor if a system DECtape) 

DIRECTORY FILE ENTRIES 


NUMBER OF BLOCKS OCCUPIED BY FILE 
FIRST BLOCK OCCUPIED BY FILE 
FILENAME AND EXTENSION 


Option switches (M) and (P) are illegal for devices other than disk 
devices (i«,e 0 , DK, RKn and DPn). The (L) switch, however, may be 
used with DECtape if the DECtape contains an operating system* 


3*3*6 List Selected File 

The directory entries of specific files or groups of files in a cur¬ 
rent UFD, a specified UFD, or a device directory may be listed selec¬ 
tively by adding elements to the L command* 


To list the directory entry for a specific file, add its file name 
and extension to the L command* For example, assuming the follow¬ 
ing UFD to be current: 
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15- 

-JUL- 

71 



DIRECTORY LISTING 

(GEP) 


1131 

FREE 

BLKS 


) DIRECTORY READER 

5 

USER 

FILES 

j 


15 

USER 

BLKS 

J 

1 

PARTA 

SRC 

1 

1 5-J UL-71 ''l 


PARTS 

SRC 

1 

15-JUL-71 | 

FILE ENTRY LIST 

PARTC 

SRC 

1 

15-JUL-71 

) 

CRDFL 

BIN 

2 

15-JUL-71 I 


TEST1 

001 

10 

15-JUL-71 J 


the command 




>L u LP u TESTl u 0j2fl+-DK) 


produces the following line printer listing: 


15-JUL-71 

DIRECTORY LISTING (GEP) 

1131 FREE BLKS 
5 USER FILES 
15 USER BLKS 

TEST1 001 10 15-JUL-71 


NOTE THAT THE HEADER REMAINS 
UNCHANGED 


DIRECTORY ENTRY OF SELECTED 
FILE 




All files within a directory which have a common file name extension 
may be listed as a selected grog?. The required L command format is: 


>L u listing dev. u #XXX-*-source dev.^ 


where: 

al # indicates the function, 

bl XXX is the common filename extension. 


For example, assuming the UFD "GEP" to be current, the command: 


>L l1 LP u #SRC^DK ) 

produces the following line printer listing: 


15-JUL-71 
DIRECTORY LISTING 
1131 FREE BLKS 
5 USER FILES 
15 USER BLKS 
PARTA SRC 1 

PASTE SRC 1 

PARTC SPG 1 


(GEP) 


15-JUL-71 
15-J UL-71 
1 5-JUL-71 


NOTE THAT THE INFORMATION CON¬ 
TAINED BY THE DIRECTORY HEADER 
IS UNCHANGED 


LIST OF FILE ENTRIES WHICH HAVE 
THE COMMON EXTENSION "SRC". 
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The (P] optional switch may be used in "selected file (s) " L com¬ 
mands. For example, assuming the UFD "GEP" to be current, the com¬ 
mand : 


>L U LP U TEST1J3J31 U (P)^-DK ) 


produces the following line printer listing: 


15-JUL-71 

DIRECTORY LISTING (GEP) 

1131 FREE BLKS 
5 USER FILES 
15 USER BLKS 

TEST! 001 2542(2) 10 15-J 


NOTE THE ADDITION OF THE FILE FIRST 
BLOCK NUMBER, PROTECTION CODE, 
POINTER TO THE FILE’S RIB AND FIRST 
RIB BLOCK. 

-71 2551 10 


Files may also be "selectively listed" from DECtape directories by 
using the device mnemonic and unit number (i.e., DTn) as the command 
"source device". The (P) option cannot be used in DECtape L commands. 


3.4 T: FILE TRANSFER COMMANDS 


The transfer of files between standard I/O devices is carried out by the 
T operation. During a basic T operation, data is read from a source 
device and is written into a named area (file) on a specified destina¬ 
tion device. In addition to basic Read/Write transfers, PIP permits 
performance of more complex operations by the use of optional func¬ 
tion switches. For example, transfer operations may include such 
optional functions as: 


a - the correction of parity errors f 

b• the conversion of tabs to spaces and vice-versa, 

c« the segmentation of large files or the combination 
of small files into a single file to be performed 
as part of the T operation. 

The T command string format is described in detail in Section 2. How¬ 
ever, as a reminder, the basic elements are: 


dest. 
dev; 

i i 

dest. 




source 

L-J 

source 


ext 

mnemonic^ 


file name 

L . J 

L- o 


dev. 

filename 

L_J 


For example: 


> T TFLJ3IN+-DT lJSOURCE^BIN ) 
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com- 


The following items should be observed when structuring a "T" 
mand? 


a* During transfers between file structured devices, 
the filename extension of the source file or an 
equivalent data mode switch must be given to en¬ 
sure that PIP can find the source file. For ex¬ 
amples 

>TjDK^ILEA u ^DTl u SOURCE u SRC ) 

b* During single file transfers* the destination file 
is named only if the name is to be different from 
that of the source file* For examples 

1 - >tjdk*dti u source.^ r c ) 

results in the contents and name af DTI file 
"SOURCE SRC" being added to the current UFD* 

2• > T u D K J^UFIL^DTl u SOURCE a SRC ) 

results in the contents of DTI file "SOURCE SRC" 
being transferred to the current UFD under the 
name "NUFIL SRC". 

c a More than one file may be transferred in one T op¬ 
eration! the files, however must be in the same 
data mode 0 In multi-file transfers, the listed 
filenames must be separated by commas; the common 
extension (BIN* ABS^ or SRC) or an equivalent data 
mode switch is required only once in the series® 

For example! 

>TJDK U TESTA,TESTB U *-DT1 JFXLEA*FILEB U SRC ) 

transfers two files from DTI into two differently 
named file areas of the current UFD* 

d. During multiple file transfers in which the source 
names are to be retained on the destination device* 
commas must ha used on the destination side o£ the 
command* The commas indicate to PIP the number of 
files involved; the number of commas used must be 
one less than the number of source files* For ex¬ 
ample* the command! 

>T JD K U * *^ d T1 l / il EA*FILjEB*FILEC |J S rc ) 

effects the transfer of three files from DTI to the 
current UFD* Note the use of two commas* one less 
than the number of source files specified* 

e* Whenever optional switches are added to a T command * 
they may be placed on either side of the dividing 
symbol (i.e. , «-) . 

>T U DT U (N) -HD^FXLEA^CA) 4- 
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3*4*1 Required Data Mode Specifications 


In transfer operations , the form of the data being handled must be 
indicated in the command string either by a Data Mode Option switch 
or by the Filename extensions used* 

The use of data mode switches or filename extensions in command 
strings is described in paragraph 2*3*4* The specific combinations 
of data mode switches and optional function switches permitted within 
the Transfer command are listed in Table 3-1 * 


TABLE 3-1* Legal Data Mode and Function Switch Combinations 
for Transfer Operations 


DATA MODE FUNCTION SWITCHES 

SWITCHES EGCWY NSFTQ 


A 

B- 

I 

H 

D 


X —X—X —X-—X — X — X —X 

I I I 

----— x——x — X 

I I 

-—— .— X —X 

I I 

---x-—X 



— x— X 


3*4*2 System Device File Protection Codes 

During file transfer operations between disk storage devices or UFD 8 s , 
the user may specify a protection code for the transferred file* 

(File protection codes are listed and described in Section 2* para¬ 
graph 2.3*7). 


For example, assuming that the UFD "JAN" is current: 


01“A UG“71 

DIRECTORY LISTING (JAN) 
2263 FREE BLKS 
0 USER FILES 
0 USER BLKS 


and that the system file protection code default value is 2, the fol¬ 
lowing series of commands: 


>T u DK^DTl u SEGA a (A) ) 
>T,JDK-*-DTl u SEGB tJ (A) ) 
>L l| LP-‘-DK |j (P)} 
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transfers files "SEGA" and "SEGB" from the tape mounted on DECtape 
unit #1 and lists the directory "JAN" with the applicable file pro¬ 
tection and RIB data: 


01-A UG-71 


DIRECTORY LISTING (JAN) 

22S0 FREE BLKS 
2 USER FILES 
2 USER BLKS 

SEGA SRC 1313(2) 1 01-AUG-71 1313 

SEGB SRC 1312(1) 1 01-AUG-71 1312 


Z_ 


file protection code 


56 

24 


As shown in the directory, file SEGA was assigned the default pro¬ 
tection code while file SEGB was assigned the specified value (i.e*/ 1) 


3o4*3 File Transfers to Disk 

Files may be transferred to disk devices from any standard input or 
mass storage device within the system* An entry for each file trans¬ 
ferred is listed in the current or specified UFD. Files may be trans- 
ferred: 

a) as a complete copy of the source file including the 
same filename; 

b) with the same filename but a specified file protec¬ 
tion code; 

c) with a new name specified for the destination file* 

Sample illustrations of the above functions appear below* 


(A) > T DK*-DT 1 TEST1 001 


CBl >T DK*-DT1 TEST2 002 (1) 


transfer file* keep same name and 
accept system default file protec¬ 
tion code . 

transfer file * keep same name but 
specify desired file protection 
code . 




CC) >T DK DESTFL«-DT1 TEST1 001 (1) transfer file, rename file and 

specify desired file protection code. 

10-AUG-71 

DIRECTORY LISTING (GEP) 

5717 FREE BLKS 
3 USER FILES 
33 USER BLKS 


TEST1 

001 

1605(2) 

10 

10-AUG-71 

1 650 

10 

TEST2 

002 

1652(1) 

13 

10-AUG-71 

1676 

66 

DESTFL 

SRC 

1700(1 ) 

10 

10-AUG-71 

1 71 6 

1 0 









Filename extension Protection code 
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3*4*4 UFD to UFD File Transfers 


Files may be read fromi 

a) unprotected UFD 8 s (code 0} 

Example commandi 

>T U DK U^ DK ti JAN> U TEST1 U (A),) 

b) protected UFD B s (Code 1) if the file protection code 

of the desired file permits the operation; 

Example commands 

>TJDK>DK 0 < JAN> lj FILEA u (B) ) 

c) the current UFD; 

Example commands 

> 1UDK t _ i <JAN>-f-DK t j:XAMP 1 _ ) (A)J 

d) one file of the current UFD into a second* differently 
named* file of the current UFD * 

Example commands 

>T^JDKjJSIUF il^dk u oldf I L u (A) 5 

NOTE 

UFD and file protection codes need not 
be considered in transfer operations 
with the current UFD* 

Files may be written intos 

a) unprotected‘UFD 8 s (code 0 ); 

Example commands 

> T j JDK l1 < JAN>^DK u TEST1 u (A) ) 

b) the current UFD or a specified file within the current 
UFD * 

Example commands 

>T u p K u TESTi-DK li JAN>,jPATCH u (A) ) 
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In addition to the above, transfer operations may be carried out between 
files of the current UFD including the creation of a new file from an-” 
other file within the UFD* For example , assuming the following UFD as 
current t 


1 1 -AUG-7 1 

directory LISTING (GEP) 


1500 

FREE 

BLKS 





3 

USER 

FILES 





24 

USER 

BLKS 





TEST! 

001 

5214(2) 

10 

ll-AUG-71 

5232 

10 

TESTS 

002 

5234(2) 

13 

1 1-AUG-71 

52 57 

66 

CONTS 

SRC 

5261(2) 

1 

ll-AUG-71 

5212 

0 


The commands 

^JOK U COUNTS^SRC^DK U €ONTS U (1) ) 

creates a new file "COUNTS SRC" from file "CONTS SRC" with a specified 
file protection code of 1, 


The operations performed result in the following UFDi 


1 1 -AUG- 
DIRECTORY I 


■71 


CGEP) 


1476 

FREE 

BLKS 




4 

USER 

FILES 




25 

USER 

BLKS 




TEST1 

001 

5214(2) 

10 

1 1-AUG-71 

5232 

TEST2 

002 

5234(2) 

13 

1 l-AUG-71 

5257 

CONTS 

SRC 

5261(2) 

1 

1 1-AUG-71 

5212 

COUNTS 

j 

SRC 

5265(1) 

1 

1 1-AUG-71 

5263 


/ 

JL 


New file 


Specified Protection code 


10 

66 

0 

0 


The capability of performing transfer operations within current UFD ? s 
simplifies these operations and enables the user to take full advantage 
of the interactive speeds of disk devices, 

3 <s 4o5 Device to Device File Transfers 

The read/write transfer of files between non-disk mass storage devices 
and/or I/O devices is performed using the same types of commands as 
described in the preceding paragraphs. Protection codes and user pass¬ 
words (UIC’s), however, are not required since these items are unique 
to disk file structures; Typical examples of device to device command 
strings are: 



a) DECtape 2 to DECtape 1 transfers 


> T U DT1 JNTE WF IL^D T 2 JD LD F I L 0 (A) ) 


b} Papertape Reader to DECtape 1 transfer: 

-i. rp Tirnl ATT7 Ta7TTTT i(A)\ 


>t u dti u newfil l 




NOTE 

When inputting information from paper tape, 
it is recommended that the (I) data mode 
switch be used unless the contents of the 
tape are known. 

ci DECtape 1 to Line Printer (listing): 

> T U LP*-D T 1 J^IEWF IL u (A) ) 

3-4.6 Transfer of Keyboard Inputs to Output Devices 

The PIP transfer "T" command may be used to transfer console terminal 
keyboard (device TT) entries (line by line) to output devices as they 
are typed. This capability is useful in the creation of ASCII source 
paper tapes or the entry of personal comments at the beginning or end 
of line printer listings. The user, however, should consider that the 
text editorial and correction features provided by PIP are minimal 
and that the service program EDIT (refer to DEC-15-YWZB-DN6) provides 
complete editorial functions. 

Once started, transfer operations of this type must be terminated by 
a CTRL D (fD entry). The CTRL D entry must be made on a separate line, 
since any data on the same line as CTRL D will be deleted from the out¬ 
put . 

Examples: 

al To punch a paper tape via keyboard entries, use: 

> t u pp u ca)^tt ) 

b). To enter data directly from the keyboard into the 
current UFD, use the following (note that a file is 
named in the command to receive the keyboard inputs): 
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>T DK KEYBD«-TT (A) 


Key board-to-Disk 
Operation Command 


THIS IS AN EXAMPLE OF THE MANNER IN WHICH DATA CAN 
BE ENTERED INTO A FILE ON THE DISK DIRECTLY 
FROM THE CONSOLE KEYBOARD. 

THE EDITORIAL COMMANDS FOR CHARACTER RUBBOUT 
AND LINE DELETION MAY BE USED IN THIS MODE OF 
OPERATION. FOR EXAMPLE 

. TITALWLE EXANPWMP 
A CTRL D ENTRY MUST BE MADE TO TERMINATE 
THE KEYBOARD ENTRY MODE OF OPERATION. 

+D 


Inputs 
from 

Keyboard 


>T TT«-DK KEYBD SRC File to Teleprinter 

Command 


THIS IS AN EXAMPLE OF THE MANNER IN WHICH DATA CAN 
BE ENTERED INTO A FILE ON THE DISK DIRECTLY 
FROM THE CONSOLE KEYBOARD. 

THE EDITORIAL COMMANDS FOR CHARACTER RUBBOUT 
AND LINE DELETION MAY BE USED IN THIS MODE OF 
OPERATION. FOR EXAMPLE 
.TITLE EXAMP 

A CTRL D ENTRY MUST BE MADE TO TERMINATE 
THE KEYBOARD ENTRY MODE OF OPERATION. 


Teleprinter 
listing of 
File 

KEYBD SRC 







3.5 FILE TRANSFERS WITH OPTIONAL FUNCTIONS 

As stated in paragraph 3.4, PIP option Function Switches may be in¬ 
cluded in "T" commands to provide the use of a broad variety of second¬ 
ary operations during file transfers. The legal switches and switch 
combinations permitted in T commands are given in Table 3-2. 

TABLE 3-2 Legal Combinations of Function Switches in 
Transfer Operations 


egcwynsftq 



Q --X-X-X—X- - X —X 



The operations provided by the use of switch functions are described 
in paragraphs 3.5.1 through 3.5.7. 

3.5.1 (G) Switch: Parity/Checksum Error Correction Facility 

During data mode (A) or (B) file-transfer operations, PIP checks the 
parity and checksum of the file(s) involved. If an error is detected, 
PIP halts the transfer and outputs on the console printer the message: 

PARITY ERR 
or 

CKSUM ERR 

depending on the error found. During (A) mode transfers, each parity 
error message output is followed by a listing of the line containing 
the error. 
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The addition of the (G) switch to (A) mode commands provides the user 
with the following options when a parity or checksum error is founds 


a. Accept the line containing the error as it is, by 
entering a } (RETURN) ; 

(PIP does not pass the parity error even if the 
line is accepted; it will change the incorrect 
parity bit to ensure even parity) 

b„ Delete the line containing the error by typing D 
and proceed; 

c. Replace the line by typing in a new correct line 
which is terminated by ) ? 

da Abort the transfer by typing CTRL P (IP) to re¬ 
start PIP or CTRL C (1C) to return to the Monitor, 

The (G) switch may only be used in I0PS ASCII data mode (A) operations. 

The following is a typical example of the use of the (G) switch: 


>T DK PARITY (AG)«-PR ■— 
PARITY ERROR ——— 

BEGIN* INXT 1 f 1BEGXN -—- 
> 

PARITY ERROR- 

• ENTER 9 FILNAM - 
> © ENTER 1 f FILNAM 

PARITY ERROR——- 



COMMAND ; 'input contents of paper 
tape to file PARITY of current UFD 
and perform parity check with (G) 
functions , 

ERROR MESSAGE 

LINE III ERROR - user enters a RETURN 
to accept tine as is. 

SECOND ERROR MESSAGE 
LINE IN ERROR 


TAG * WRITE 1,2* @.UF,34 

>TAG © WRITE ! f 2 f BUF f 34—i 


user enters new line with correction 


'I THIRD ERROR MESSAGE 


■j user enters new line with correction 


3*5,2 (E) and (C) Switchess Tab-to-Space, Space-to-Tab Conversion 


Listing devices may or may not have tabbing mechanisms; therefore, 
it is sometimes necessary to convert file tab and space delimiters to 
meet the needs of the listing devices. 


&) (E) Switch - the addition of switch (E) to a n T" 

command string causes all Tab codes in the trans¬ 
ferred file to be converted to the number of 
spaces required to achieve the same spacing of the 
printed material as would be obtained if a Tab were 
present* 



The (E) switch may only be used in data mode (A) 
transfer * Following is a typical example of a T 
command incorporating an (E) switch: 

>T tJ TT^DTl L PILEA fc jAE)^ 


b) CCl Switch - the addition of switch (C) to a !5 T U 
command string causes any group of two or more 
contiguous spaces to be converted to a Tab code 
in the transferred file according to the follow-* 
ing rule: 

i) a tab character is output for each 
tab-stop position which is reached 
or exceeded by the group of spaces® 

ii) any spaces occurring after the la*st 
tab stop position* which was reached 
by the group of contiguous spaces* 
are output® 

The effect of this operation is that a print¬ 
out of the resulting file will look as if the 
C switch had not been invoked* but the opera¬ 
tion* reading a tab position will be performed 
via tab characters* whenever they were formerly 
reached by spaces® 

Note that any group of spaces* which fails to 
reach at least one tab stop position* will re¬ 
sult in the output of just that set of spaces 
without any tab characters® Note further* that 
any group of spaces ending at a tab stop posi¬ 
tion will result in the output of more tab char¬ 
acters without any spaces® 

The (C} switch may only be used in data mode (A) 
operations. 

Tiie following is a typical example of a T command 
incorporating a (C) switch: 

> TjJTT^-DT L / ILEA^ (AC) ) 


3*5-3 (N) Switch: Directory Initialization During Transfer 

In addition to being a Primary PIP operation, the New Directory N 
command may also be used as an optional function to be carried out in 
the context of other operations. The (N) option may be used to initial¬ 
ize directories on both disk and DECtape mass storage devices. 

Switch (N), when used in a transfer to disk operation, initializes 
the UFD associated with the current user. 


Used in a transfer to a non-existent UIC* the (N) switch causes a UFD 
to be set up under the specified UIC. The transferred file then ap- 
pears as the first entry in the new UFD. 
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Transfers made to DECtape devices by T commands containing the (N) 
switch initialize the DECtape directory and write the transferred 
file(s) onto the tape. 

The following example illustrates the use of the (N) switch in T 
commands. 

Assuming the file TEST1 001 to be present in the current UFD, the 
command: 


>T u DK u <XYZ> - ! -DK u TEST1 u 0J2(1 u C n ) ) 

sets up a new UFD under the UIC "XYZ" and transfers the file TESTl 001 
into the new UFD as its first entry as follows: 

i i-AUG-71 

DIRECTORY LISTING (XYZ) 

146:5 FREE BLKS 
1 USER FILES 
10 USER BLKS 

TEST! 001 10 ll-AUG-71 

UFD's established in this manner are automatically given a UFD protec¬ 
tion code of "0". 

3.5.4 (W) Switch: Combining Files During Transfers 

The (W) combine file switch, when incorporated into a T command, en- 

a ^ Yes the user to read two or more files from a source device and write 

them, in the indicated sequence, into a single file on the destination 
device. 

The (W) switch may be used with data mode switches (A) , IOPS ASCI 
and (B), IOPS Binary* 

During (W) operations, PIP pauses and outputs a tP (when input is 
from a non^directoried device) at the console teleprinter after 
each file is transferred• The user must respond with a fP entry 
to continue the transfer operation* 

For example f the command: 

>T U DT1 U C0MTST^DT2JTEST1,TEST2,TEST3 U (BW)) 
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results in the binary files TESTl f TEST2 f and TESTS being written 
into the file COMTST on device DTI® With a source file*? the pseudo- 
operators *EOT or *END which occur at the end of all but the last 
of the files being combined are deleted to enable the resultant 
file to be processed as a single continuous file. 


The following is an example of a combine files (W ), transfer operations 


17-FEP-71 

DIPECTOPY LISTING CGEP) 

6163 FPEE ELKS 

2 USEP FILES 

2 USEP PLKS 

SEGA SPC 1 17-SEP-71 

SEGB SRC 1 17-SEP-71 




>T DK EXAMP PPC (AW) «-DK PEGA FPC,PEGB PPC 


LISTING OF CURRENT UFD 


COMBINE FILES COMMAND 


1 7-PEP”71 

DIPECTOPY LIFTING CGEP) 


S1S2 FPEE PLKP 


3 

USER 

FILES 

i 

I 

l LISTING OF 

CURRENT UFD 

X 

USEP 

PLKS 


) SHOWING NEW 

' FILE "EXAMP" 

SFGA 

Cp Q 

i 

17-FEP-71 

CREATED BY 

COMBINING FILES 

SFGP 

SPC 

1 

1 7-PEP-71 

"SEGA" AND 

"SEGB". 

EXA^P 

SFC 

1 

1 7-PEP-71 J 




.TITLE EXAMP 
.1 ODFV 1,?. 

r.E.GIN .1 NIT 1,1, BEGIN 

.ENTEP 1,FILNAM 
.EOT 


LISTING OF FILE "SEGA" 


r 


TAG . UP IT E l,?,Pl!F,3/< 

.EOT 


LISTING OF FILE "SEGB" 


.TITLE EXAMP 
.1 OPE'/ 1,? 

BEGIN sINIT 1,1,BEGIN 

.ENTEP 1,FILMAM 
TAG .W^TTF I,2,P.|JE,34 

. ro T 


A 


> 


LISTING OF NEW FILE "EXAMP" 
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3*5.5 Inputting and Combining Files from Paper Tape 


The (W) option with a transfer operation permits the user to input 
files from separate paper tapes and to combine the files into a single 
named file on a specified destination device. 


The procedure required is: 


1) The first tape to be read should be loaded into the 
paper tape reader (PR) * 

2) The user must specify in the command string the num¬ 
ber of paper tapes to be read. This is done by fol¬ 
lowing the source device mnemonic (i.e., PR) by N-l 
commas (,) where N is the total number of tapes to 
be read. For example , the command: 

^u^^UFILE^AW) *-PR u , ,,,) 

specifies that five (5) paper tapes (4 commas) are 
to be read in IOPS ASCII data mode and combined into 
a single file (NUFILE SRC) located on DECtape unit #1. 

3) The termination of the command string causes the first 
paper tape to be read. PIP pauses after each tape is 
read to permit the user to place the next tape in the 
reader. A pause is indicated by the printing of "tP" 
at the console printer. 

4) Until the last tape is read, the user must enter 
CTRL P (tP) after loading each new tape to continue 
the input operation. PIP determines which is the 
last tape to be read from the number specified in the 
command string and terminates the operation after 
the last tape is read. 


3.5.6 Card Input and Card File Modification Operations 


The Transfer operation may be used to input files from punched cards. 
The format of the data being input from cards may be modified by add¬ 
ing one or more of the following switches to the T command: 


11 (Q5 Switch — The addition of a (Q) switch causes 
the information input from card columns 73 through 
80 (card sequence numbers) to be deleted. This 
switch may be used only in an (A) data mode trans¬ 
fer operation and only on information which is in 
a card format. That is, the Q switch may be used 
during.the.transfer of files, the contents of which 
are still in card format, as well as during the in¬ 
put of data from the card reader. Examples of the 
command strings used are as follows: 


a) To modify input from card reader 
T U DT1 U FILEA U (AQ)^-CD ) 




bl To modify file data format during storage 
device transfer operations: 

TJDT1 U FILEA^DT1 U S0URGE U (AQ)) 

2} (Cj Switch - The (C) switch (spaces-to-tabs) may 
be combined with the (Q) switch to further modify 
the contents of files being input or transferred. 
The following is an example of a command string 
containing both the (C) and (Q) switches: 

T,JDT1 u FILEA^DT2 u S0URCE l _ 1 (AQC) ) 

3) (T) Switch - The (T) switch (delete trailing 

spaces) may be combined with either the (Q) 
switch or both the (Q) and (C) switches to fur¬ 
ther modify the contents of files being input or 
transferred. The following is an example of a T 
command string which contains all three modifying 
switch options: 

TjJDTIljFILEA^DT2 u S0URCE q (AQCT) ) 


NOTE 

The Q switch cannot be used to modify the 
contents of files which have been previ¬ 
ously modified by the use of either or both 
the (C) and (T) switches since the contents 
would no longer be in a card format. 


3*5*7 CTl Switch: Delete Trailing Spaces 

The (T) option switch may be added to transfer commands used to input 

data, from a car’d reader- or to transfer fries containing data in a 

punched card format (i.e., 80-character ASCII data groups) * The use 
of the CTl switch causes PIP to locate and insert a RETURN ( } ) charac¬ 
ter immediately after the last non-blank character in each file (or 
input), card-format data group. The (T) switch thus deletes the trail¬ 
ing spaces which result from inputting the unused portions of the origi¬ 
nal punched card sources. 


3.6 V: VERIFY OPERATION 

XOPS ASCII or Binary files may be checked for parity and checksum er¬ 
rors by using the PIP Verify V operation. 

Data mode switches (A) IOPS ASCII and (B) IOPS Binary are the only 
optional PIP switches permitted with V operations. 
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The Verification command string requires: 


a] the V operation control character; 

B1 the mnemonic of the device containing the file to 
be examined; 

cl the filename and extension of the file being 
checked; 

d) data mode switch (A) or (B). As in the T command, 
the mode switches may be dropped if the extensions 
SRC or BIN are used; conversely, these extensions 
may be dropped when the mode switches are indicated. 
Note that in multiple file verifications^ all 
files must be of the same data mode (i s e® F all 
TOPS ASCII or all Binary)® 


COMMAND STRING EXAMPLES: 
al the command 

V u DK t /ILEA a CA) ) 

will verify the file FILEA SRC listed in the UFD of 
the current user (UIC)„ 

bi the command: 

VJ>R U CB).) 

verifies the contents of a binary paper tape mounted 
in the paper tape reader. 

c) the command: 

VjJDT3yFILEA,FILEB,FILEC U (A) ) 

verifies three ASCII files contained on DECtape unit 3. 


T£ either a. pairt-hy oar a. checksum error a_s detected during a. Verify op 

eration, the message: 


w PARITY ERR" 
or 

"CHKSUM ERR” 

is output at the console printer by PIP* 

A Verify, V, operation is interrupted only .for the printing of error 
messages, it continues the verify operation until the entire file has 
been examined. 


During verification of I0PS ASCII files (mode (A)) the line contain¬ 
ing each detected error is printed at the console printer immediately 



after the error message printout* The following is an actual example 
of the error message/error line printout obtained during the verifica¬ 
tion of an ASCII file. 


V PR (A) 

PARITY ERROR 
START W0 

PARITY ERROR 

JMP TE -- 

PARITY ERROR 

'? - i 1 — .. IP "" 

parity error 

TFLP 0 . J 


Lines in the fiZe which 
contain a detected error 


3.7 Si SEGMENT FILE OPERATION 

PIP provides commands which enable a single IOPS ASCII file located 
on either a mass storage device (e.g., DT, DK, DP, RK r MT) or a paper 
tape to be segmented into up to 16 individual files or tapes. The PIP 
segmentation operation is initiated by an S (segment file) command fol¬ 
lowed immediately by a T (transfer) command containing a (Y) option 
switch. 


NOTE 

The (Y) switch may only be used with data 
mode switch (A), (IOPS ASCII). 

3.7.1 S, Segment File Command 

The S command enables the user to specify up to 16 “segmentation 
points" within a file that is to be segmented. 

A segmentation point is defined as a group of from 1 to 5 characters 
which identify a specific line within a file. The characters of a 
segmentation point must appear in the FIRST five character positions 
of a line. 

Each segmentation point indicates to PIP that all lines of the file 
from the beginning of the file or the preceding segmentation point, 
up to but not including the current segmentation point, are to be 
transferred as a single file. 
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The format of the S command command string is as follows: 


SuSEGl,SEG2,..• B SEG15 * SEG16 

As shown above , commas must be used as delimiters between the speci¬ 
fied segmentation points. 

3*7.2 T Command Requirements for S Operations 

The T command used in file segmentation operations musts 


a} contain a (Y) switch; 

h\ name a corresponding destination file for each seg¬ 
ment of the source file; 


NOTE 

The number of destination filenames re¬ 
quired in a T command is equal to the 
number of S command segmentation points 
plus 1. 


cl contain the source device mnemonic and source file¬ 
names and extensions. 

d) immediately follow the S command* 


During S operations: 

a) PIP examines the file line-by-line for the segmenta¬ 
tion points specified in the S command, 

&) As each, segmentation point- is £ou.nci , PXP appends tb.e 

appropriate pseudo-op (,END or .EOT) to the defined 
segment and transfers it to the corresponding destina¬ 
tion file. 


Assuming the following file present in the current UFD: 

e TITLE EXAMP 



.IODEV 

1 *2 

BEGIN 

• INIT 1 

,1.BEGIN 


.ENTER 

1.FILNAM 

TAG 

.WRITE 

1 ,2., BUF, 34 


.CLOSE 

.EXIT 

1 

BUF 

LI-.72*1000+2; 0 

LI r. 

.ASCII 

'HEJ! 1 <175> 

FILNAM 

.SIXBT 

’DTIO DAT' 


* END BEGIN 



the manner in which file EXAMP may be divided into three segments, 
with each segment a separate named file, is shown in the following 
example: 

>S BEGIN,TAG 

SEGMENTATION S AND T 
COMMANDS 

>T DK PARTA ,PARTB ,PARTC (AY) «-DK SEGEX SRC 

tP 

tP 

TP 

TP 


>L TT«-DK 




LIST 

CURRENT 

UFD 

11» 

AUG- 

71 





DIRECTORY LISTING 

(GEP) 




1510 

FREE 

BLKS 





4 

USER 

FILES 





4 

USER 

BLKS 





PAPTA 

SRC 

1 

1 1 -A UG-71 




PARTB 

SRC 

1 

11-AUG-71 




PARTC 

SRC 

1 

1 1 -A UG-71 




SEGEX 

SRC 

i 

1 1-A UG-71 




>T TT*-DK 

PARTA CA) 


LIST 

SEGMENT 

A 


.TITLE 

EXAMP 


elODEV 

1,2 


• EOT 



>1 TT«-DK PARTB 

(A) 




LT&T SEGMENT B 


BEGIN .INIT 1,1.BEGIN 

.ENTER 1.FILNAM 
.EOT 


>T TT<-DK PARTC (A) 


LIST SEGMENT C 


TAG .WRITE 1 ,2,BUF,34 

.CLOSE 1 
.EXIT 

BUF LI-./2*1000+2$ 0 

.ASCII 'HEJ! * < 1 7 5 > 

LI =. 

FILNAM .SIXBT 'DTIO DAT' 
.END BEGIN 
.EOT 
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3 o 7 * 3 Source File to Multiple Paper Tapes Segmentation Operations 

The segmentation of a file and the outputting of each segment onto sep 
arate paper tapes is performed in a manner similar to that described 
in paragraphs 3,7,1 and 3.7.2. The use and format of the S command 
is the same, the T command differs as follows: 

No destination filenames need be used in the T command; 
however, a series of commas must then be used to indi- 
cate the number of paper tapes required. 

For example, the commands needed to segment file EXAMP (refer to pre¬ 
vious example! onto 3 paper tapes are: 

>S BEGIN,TAG/) 

>T^jPPt_s , (Y)^DKs«jEXAMP*_jSRC J 


The operations performed by PIP when outputting file segments onto 
paper tape are similar to those described in paragraph 3.7.2. 


When a file is segmented and the segments are output onto paper tapes: 


1! An .EOT pseudo-operation is appended to the end of 
each segment. 

21 With the exception of the last output tape, PIP 
pauses after each segment tape has been punched 
and causes a fP (CTRL P) message to be printed 
at the console printer. The pause permits the 
user to remove each tape before the next one is 
punched. 

3) The user must enter CTRL P (*P) to continue the 
segmentation operation after each pause. 

41 When the last tape is punched, control is returned 
to PIP from the segmentation operation. 


3 o8 D: DELETE FILE OPERATION 


The Delete operation enables the user to delete files from user direc¬ 
tories. The basic command format is: 


> D u de v ice containing file(s) ^f ilename^extension p 


for example: 


>D uP K u. FIIiEA Li SRC ) 






More than one filename may be listed in a D command; however, they"- 

must be separated by commas. For examples 

>DyDKyF XLEAySRC # FILEB U SRC, FILECySRC | 


NOTE 

The complete name (filename and extension) of 
the file(s) must be specified exactly as entered 
in the directory from which they are to be de¬ 
leted, If more than one file in a directory has 
the same name, PIP will delete the first file of 
the specified name which it finds. 


One option switch, (X), is permitted in the Delete command* This 
switch deletes all truncated files from the current or a specified (un 
protected) UFD* The following are examples of the use of the (X) 
switchs 

a) 5 for current UFD; 

b) >D l pK l f AAA> U (X) ^ for specified UFD * 

3.8*1 Deletion of Files from UFD s s 


When a file is deleted from a UFD, its entry is removed from the user 
directory and the quantities given in the Directory listings (i«e®, 
FREE BLKS, USER BLKS and USER FILES) are adjusted to reflect the de¬ 
letion* 

Files are deleted from the current UFD by using the basic D command* 
For example, assuming the following directory as currents 


02-AUG-71 

DIRECTORY LISTING (JAN) 

5751 FREE BLKS 
2 USER FILES 
11 USER BLKS 

TEST 1 001 10 02-AUG-71 

MIN SRC 1 02-AUG-71 


the command 


>d lPK u TEST1 l /0 1 ) 


results in the deletion of the file "TESTl 001" as illustrated in the 
following listing of JANs 
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(JAN) 


02-AUG-71 
DIRECTOPY LISTING 
5761 FREE BLKS 
1 USER FILES 
1 USER BLKS 
MIN SRC 1 02-AUG-71 


More than one file may be deleted from a directory during a D opera¬ 
tion. The deletion of four files by a single D command is shown in 
the following: 


>L TT«-DK 


1l-JUN-71 


DIRECTORY LISTIN8 (SEP) 


2251 

FREE 

BLKS 



10 

USER 

FILES 


10 

USER 

BLKS 



SE SB 

SRC 


1 

1 l-JUN-71 

SESA 

SRC 


I 

ll-JUN-71 

EXAMP 

SRC 


1 

1 l-JUN-71 

TTYFL 

SRC 


1 

1 l-JUN-71 

PARTA 

SRC 


I 

1 l-JUN-71 

TTYFLB 

SRC 


1 

1 l-JUN-71 

PARTB 

SRC 


1 

1 l-JUN-71 

PARTC 

SRC 


1 

1 l-JUN-71 


Original UFD 


>D DK SE6B SRC,SE6A SRC,TTYFL SRC,TTYFLB SRC Delete Command 


> L JTT«-DK 


(SEP) 

Revised UFD 

1 l-JUN-71 

ll-JUN-71 

ll-JUN-71 

ll-JUN-71 


ROTE 

The protection code assigned each individual 
file is overridden by the UFD protection code. 
If the UFD is unprotected (code 0) any file it 
contains may be deleted by other users of the 
system regardless of the protection code of 
the individual file. 


1 l-JUN-71 
DIRECTORY LISTING 
2255 FREE BLKS 
4 USER FILES 
4 USER BLKS 

EXAMP SRC 1 

PART A SRC 1 

PARTS SRC 1 

PARTC SRC 1 



3.8.2 Deletion of DECtape Files 


Wlien a file is deleted from a DECtape directory, all references to 
the file are removed from the directory and the File Bit Map blocks. 

The command format is the same as that described for the basic opera¬ 
tion. For example, to delete a file from device DTI, the commands 


>DjJDTlyf ilenameyextens ion } 


is used* 


3*8*3 CX) Switch: Deletion of Truncated Files 


The use of the (X) optional switch in a 8S D iS command deletes all trun¬ 
cated files contained by the current UFD or any specified non-current 
UFD (unprotected). For example^ assuming the following UFD as being 
currents 


i 6-SEP* 71 

DIRECTORY LISTING C GEP) 

5 372 FREE BLKS 

2 USER FILES 

3 USER BLKS 

SEGEX SRC 3 IS- SEP-71 

• IFILi EDT^ 0 1 6-SEP® 71 


the command: 


>DJDK U (X); 


causes the truncated file 11 .TFXLl EDT*" to be deleted from the UFD. 
The resulting UFD appears as: 


1S-SEP-7! 

DIRECTORY LISTING (GEP) 

5 43 6 FREE BLKS 
i USER FILES 
3 USER BLKS 

SEGEX SRC 3 1 6- SEP- 71 


3*9 R: FILE RENAME OPERATION 


The PIP R operation enables the system user to: 

a) Change filenames within current UFD * s , specified 
UFD’s and DECtape directories; 
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b) change the protection code for the current or speci¬ 
fied UFD r s; 

c] change the protection codes of files within the cur¬ 
rent or specified UFD 8 s„ 

The basic format for the R command is: 

>Rydirectory devicejjnew name u ext^-directory device u old name u ext } 

The "directory device" must be the same on both sides of the back- 
arrow («-) . This is the device which contains the file to be operated 
upon by the R command. 

3.9.1 Renaming Files 

Files within the current UFD or located in DECtape directories may 
be renamed using the basic R command. For example, assuming the 
following UFD to be currents 




16-SEP-71 

DIRECTORY LISTING CGEP) 

5 436 FREE BLKS 
1 USER FILES 
3 USER BLKS 

XMPLE SRC 3 02-FEB-91 


Oriqinal 
UFD 


J 


The 


filename 


"XMPLE" 


is changed to 


"SEGEX" by the following: 


>R DK SEGEX SRC -DK XMPLE SRC 


>L TT-DK 

16-SEP-71 

DIRECTORY LISTING (GEP) 
5436 FREE BLKS 


Rev ised 


1 USER FILES 
3 USER BLKS 

SEGEX SRC 3 16-SEP-71 


UFD 
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Files on DECtape are renamed using the same command format as shown 
for disk (UFD} files. 

3.9.2 Setting File Protection Codes 

R commands may be used to change both the name and protection codes 
for disk files. The format for this function is: 

>R u device u new name u ext^-device u oId name u ext u (#) ) 

where (#) is the specified file protection code (see Table 3-4 for 
codes) o 

For example p assume that the revised UFD of the preceding example is 
still current , the file protection code of file "SEGEX SRC 19 is changed 
from 2 to 1 in the following manner: 

>R DK SEGEX1 5RODK SEGEX SRC Cl) r command 


>1 TT«~DK CP) 

16-SEP-71 

DIRECTORY LISTING C GEP) 

5436 FREE BLKS 
1 USER FILES 
3 USER BLKS 

SEGEX1 SRC 2201 Cl) 3 16-SEP-71 2205 




UFD listing 
showing new 



74 


J 


3.9.3 Setting Directory Protection Codes 

R commands may specify a new protection code for the current or a 
specified UFD. The following command format is required for this 
•function. 


>R u disk L f XXX: Z> ) 


where: 

1) XXX is the 3-character UIC of the UFD involved 

2) : is the required delimiter for this function 
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3} Z is the protection code to be assigned to the 
specified UFD% 0 = unprotected; 1 = protected. 



For examples 


»L TT^-DK CM) 


ll-JUM-71 

MFD DIRECTORY LISTING 
2255 FREE BLKS 
45 USER FILES 
515 USER BLKS 



J 


Original 
MFV indicates 
that no un¬ 
protected 
UFD r s are 
in the system 


DK <iEPf0> 


o 


>L TT«-DK CM) 



ll-JUN-71 

MFD DIRECTORY LISTING 
2255 FREE BLKS 
43 USER FILES 
515 USER BLKS 
GEP 1003(0) 4 4 


Revised MFD 
showing the 
unvroteoted 
UFD "GEP" 




3.10 B: BLOCK COPY OPERATION 

The PIP B operation enables the user to copy the contents of selected 
storage blocks or ranges of blocks from one device into specified 
blocks of another similarly structured device. For this operation 
the user must specify: 

1) the destination device and the storage blocks which 
are to receive the copied information , 

2) the source device and the specific blocks which are 
to be copied. 


The command format required is: 


>Bi_jDest.Dev.uList of Rec. Blocks^Source Dev oL _jList of Blocks to be copied^ 


The blocks to receive data and those which are to be copied are identi¬ 
fied by their respective octal numbers. 
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A series of nan-consecutive blocks (either source or destination) is 
specified by listing their octal numbers* in sequence* separated by 
commas (required delimiter). For example: 

> B ljDTl u 50,55,60^DT2 U 101 * 107 *200 ) 

specifies that the contents of blocks 101* 107 and 200 on DT2 are 
to be copied into blocks 50, 55* and 60 of DTI (i,e„* 101 to 50* 

107 to 55* and 200 to 60). 

A series of consecutive blocks (either source or destination) may 
be specified as a range of numbers. The range is specified by list¬ 
ing the first and last block numbers of the series separated by a 
dash (-)* the required delimiter. For example: 

>B U DT1 U 50-55^DT2 U 100-105 ) 

specifies that blocks 100* 101* 102* 103* 104 and 105 of DT2 are to 
be copied into blocks 50* 51* 52* 53* 54 and 55 of DTI. 

When data is to be copied from and written into the same blocks on 
both source and destination devices* only one set of block numbers 
is required. For example: 

>B U DT1 U 1*2,4^DT2 ) 

and 

>B u DTl^DT2 Li l*2*4 ) 

specify that blocks 1* 2 and 4 are to be copied from DT2 into blocks 
1*2 and 4 of DTI. 

UIC block copy operations are permitted between the following devices 

a) Disk Area to DECtape permitted for the UIC user. 

b) DECtape to DECtape permitted for any system user. 

Option switches (N) and (S) may 
be included in B commands for 
this type of operation. 

In all copy operations * the data transferred (copied) is automatically 
verified. 
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3.11 Ct COPY MASS STORAGE OPERATION 

The PIP C operation provides the system user with the ability tot 

a} add the contents of one device to that of another 
device 

bl copy the complete contents of one file-structured 
device onto another similarly-structured device« 

The format for the C command is: 

>Cyd'es tination device^source device ) 

The following option switches may be added to the C commands 

a) (Nl New Directory switch 

Permits destination device directory to be initialized during 
C operation* 

b) CS) Initialize with QAREA switch 

Initializes the directory of the destination device and estab¬ 
lishes a i QAREA on the device prior to the copy operation. 

cl (H) Image Mode switch 

K mode copy is a total replacement operation in that each block on the 
destination device is replaced by the corresponding block of the source 
device. This form of copy, therefore,, may only be used between like 
devices (i.e., DP to DP, DT to DT); it is most useful for copying DEC- 
tapes a As each block is written onto the destination device, a word- 
by-word comparison is made between the destination block and source 
block to ensure accuracy. If an error occurs, the number of the block 
containing the error is output on the console printer. Once the copy 
operation is complete the blocks which contain errors may then be re¬ 
copied using the Block Copy (B) function; this eliminates having to 
repeat the entire device copy operation. 

All available free core is used during H Mode Copy operations; the 
more core that is available the faster the copy operation. It is 
therefore advantageous, prior to calling PIP, to assign only those 
handlers needed for the copy operation using the A (Assign) monitor 
command. For example, the fastest possible copy operation between 
DECtapes is achieved by assigning handler DTE to all possible .DAT 
slots. 
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3.11.1 Adding Files, Copy Operation 


THe use of the basic C command results in files being copied from the 
source device and added to the contents of the destination device. 

For example, the commands 

>CyDTl«-DT2 ) 

causes the files on DT2 to be added to the contents of DTI. 

The basic copy (i.e., add-on) operation is permitted between: 


DEVICES 


a) DECtape to Disk 


b) Disk to DECtape 


cl UFD to UFD 


d) DECtape to DECtape 


OPERATION PERFORMED 


integrates all DECtape files into 
the current UFD. A typical com¬ 
mand is s 

>c lP k u^ dt1 ) 

integrates all files contained by 
the current UFD onto the specified 
DECtape. A typical command is: 

>CyDTl«~DK } 

copy operations (i.e., the integra¬ 
tion of files) may be carried out 
between the current UFD and an unpro¬ 
tected UFD o For example, the com¬ 
mand : 

>C U DK li JAN>«-DK ) 

adds the files of the current UFD 
to the UFD "JAN". 

Copy operations may also be per¬ 
formed between the current UFD and 
a protected UFD; however, truncated 
files and files with a protection 
code of 3 are not copied. 

integrates all files from the 
source device onto the destination 
device.' A typical command is: 

>C U DT1^DT2 ) 

NOTE 

If the destination device cannot 
store all of the input files, all 
possible files are copied and an er¬ 
ror message printed at the console 
teleprinter. 
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Assuming a current UFD containing the file "XMPLED SRC”, the following 
is an example of a basic copy (i.e.> C) operation: 


02-AU6-71 
01 RECTORY LISTING 
1066 FREE BLKS 
1 USER FILES 
10 SYSTEM BLKS 
EOTST SRC 1 2 


DT0 DIRECTORY BEFORE 
COPY OPERATION 


>Cj_jDT0^DK^ 


COPY 'CONTENTS OF CURRENT 
UFD ONTO DT0 


02-AUS-71 
DIRECTORY listing 
1062 FREE BLKS 
2 USER FILES 
10 SYSTEM BLKl 

EOTST SRC 1 2 

XMPLED SRC 2 4 


DT0 DIRECTORY AFTER 
COPY OPERATION 


3.11.2 Copy with Directory Initialization 


Switches (N) and (S) may be added to C commands to initialize the 
directory of the destination device. 

The (N) switch is used in the following manner: 


a) Copy to System Device 
Operations 


b) DECtape to DECtape copy 


When added to a basic C com- 
mand, the (N) switch either 
initialises the UFD for the 
current or specified UIC or 7 
if no UFD exists, creates a 
new UFD. 

For example, the commands 

>C U DK < JAN> u (N)-H3Tr ) 

first initializes the UFD for 
UIC "JAN" or, if none exists 
creates one, then the files 
contained by DTI are incorpo¬ 
rated into the UFD for ”JAN". 

When added to a DECtape to 
DECtape C command, the (N) switch 
initializes the directory of the 
destination device before the 
copy operation is carried out. 



The (S) switch is permitted only for DECtape to DECtape copy opera¬ 
tions . This switch initializes the directory of the destination de¬ 
vice and establishes a QAREA on the device prior to the copy operation. 

When the (S) switch is used alone, the fQAREA reserved on the initial¬ 
ized device has the same size as the core available in the system. 

For example, the command: 

>CyDTl u CS^DT2 ) 

will: 

a) initialize the directory of DTI, 

b) reserve a +QAREA on DTI equivalent in size to the 
core contained by the system, 

c) copy the contents of DT2 onto DTI. 

Two digits may be added to the (S) switch (i.e., (Snn) to indicate in 
| 4K (i.e., 4096-word) units the size of the iQAREA to be reserved). 

This size is normally specified in 4K units starting at 16K (minimum 
DOS core requirement). For example, the command: 

>CyDTly (S32) -H3T2 ) 

initializes the directory on DTI, causes a 32K fQAREA to be reserved 
on DTI and copies the contents of DT2 onto DTI. 

3.12 U: UPDATE STORAGE ALLOCATION TABLES OPERATION 

I It is possible for areas on disk devices to be faulty or damaged 
in such a manner that they cannot be read from or written on. 

When a faulty area is detected, the Monitor outputs an error 
message which describes the condition and lists the block number of 
the bad area. 

On the detection of faulty read/write disk areas, the current user 
§ must delete the current file where the error was indicated, then 
utilize the PIP UPDATE operation to: 

a) Cause the system Storage Allocation Table (SAT) 

to be updated to reflect the removal of the faulty 
blocks from "available storage". 
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hi Update the system Bad Allocation Table (BAT) with 
the numbers of the detected faulty blocks„ If no 
BAT exists , the table is created by the update op¬ 
eration. 


The command string format for a PIP U operation is: 


>U|_|DKyN J 


where N may: 


a) be the octal number of one faulty block or a series 

of numbers identifying a list of non-sequential faulty 
blocks. 

For example, the command: 

>U|jDKjjlj2fl, 105,115 ) 

updates the BAT and SAT to indicate that disk stor¬ 
age blocks 101, 105 and 115 are faulty. 

b) Indicate a range of numbers which describes a series 
of contiguous blocks which are found to be faulty. 

For example, the command: 

>U U DK U 101-105 ) 

updates the BAT and SAT to indicate that disk stor¬ 
age blocks 101 through 105 are faulty. 


On completion of each UPDATE operation, PIP outputs the message 


n BAD BLOCKS IN SYSTEM 


on the console printer. The letter "n" represents a number which 
dicates the total number of bad blocks on the disk. 





SECTION 4 


MIC PIP OPERATIONS 


4.1 GENERAL PIP MIC OPERATIONS 

The system manager* when logged in under the Monitor Identification 
Code (MIC), can perform all of the operations described in Section 3; 
he is required only to specify the UFD or device involved. For 
example* to transfer a file between UFD’s the MIC enters a command 
similar to the followings 

>T L f>K u < JAN> L JDESTFL^"DK L f GEP>ySOURCE u (A) ) 

Protection codes* file or UFD* do not apply to the MIC. 


4.2 SPECIFIC MIC FUNCTIONS 


The following paragraphs describe PIP operations which are unique to 
the MIC or give different results to the MIC user. 


4.2.1 N Operation 

The MIC user may initialize any user UFD or DECtape directory in the 
system by specifying the directory's UIC or device/unit mnemonic in 
the command. For example: 


a) >N U DK U <JAN>) 

clears all files from the UFD identified by the 
UIC "JAN". 

b) >N L jDT1 ) , 

clears the directory of DECtape unit #1. 


WARNING 

The command ">NyDK} " issued by the MIC* 
initializes either the PAG (page mode) or 
BNK (bank mode) system UFDs. If either of 
these UFD's is initialized* the current 
operating system is destroyed and the sys¬ 
tem must be restored. 



4*2*2 L f List Directory Operation 


Tlie only difference between the UIC and MIC "L" operations is that in 
listing the MFD, the MIC user obtains a complete listing of all UFD's 
in the system, regardless of their respective protection codes* 


For example , the listing obtained by the commands 
>LyLF^DK CHI ) 


a} by a standard user (UIC) - 


02-AUG-71 

MFD DIRECTORY LISTING 
5766 FREE BLKS 
52 USER FILES 
641 USER BLKS 


b) by the MIC - 


02-AUG-71 

MFD DIRECTORY LISTING 
5766 FREE BLKS 
52 USER FILES 


641 

USER BLKS 



BNK 

1000(1) 

5 

157 

PAG 

1001(1) 

5 

160 

I OS 

1002( 1) 

30 

247 

SCR 

NO N ( 1 ) 

0 

0 

WAD 

1240(1) 

1 

4 

JAN 

1566(1) 

1 

1 

TMP 

1573(1) 

6 

26 

GEP 

NON (1 ) 

0 

0 


4*2*3 Delete Truncated Files from System 


A Delete command with an (X) option switch issued by the MIC will de¬ 
lete all truncated files from all UFD ! s contained by the operating 
system* The command required iss 

>D|jDKjj(X) ) 

4*2*4 I , Initialize Operation 

The use of this operation clears all of the system device bit maps 
and initializes the MFD* Initialization of the MFD sets it to a de¬ 
fault state* The system is completely destroyed* The required command 

is % • —' ~~ 

>IuDK) 
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SECTION 5 


PIP ERROR DETECTION PROCEDURES AND MESSAGES 


5.1 INTRODUCTION 

Tliis Section describes the error detection* reporting and corrective 
procedures employed in PIP operations• Only the error messages and 
procedures output and followed by the PIP program are described. A 
complete list of system error messages (IOPS) is given in Appendix D. 

PIP error detection and reporting operations are concerned primarily 
with! 

al the detection of errors in the user command string* 

b) the detection of errors during the performance of 
the user-requested operation. 

5.1.1 User Command String Errors 

When each input command string is terminated* PIP immediately scans 
the entered string for such items as: 


a. Format errors* 

b. Error in function requested* 

c. Conflicts in requested function* 
d* Completeness of information. 


Errors In the command string are normally handled in the following 
manner; 

a. A message identifying the error found is printed 
on the console teleprinter* 

b* the command string entered is retyped by PIP* on 
a separate line up to the point where the error 
was detected. PIP outputs a question mark (?) at 
the point of the error* 

c. the user may enter CTRL P or carriage return to 
abort the operation or may complete the command 
string from the ? symbol on* entering the needed 
correct information. The latter should initiate 
the requested operation if no further error exists. 



EXAMPLE: the following is an example of the detection, reporting 

and correction of a command string error: 


L TT«-«WCK> — -■——-- Command String Entry 

ILLEGAL DEVICE OR UNIT - —- Error Message 

,L TT«-?J)K <VCK> 

I ————-— Corrections entered by User 

PIP reprint to Error Point (?) 

In the above example, the user forgot to enter a source device mnemonic 
(i.e., DK). PIP detected the error, output an error message and that 
part of the command line up to the error (i.e., >L_TT«-?) ; the user 
chose to complete the operation and entered the needed data (i.e., 

DK < WCK> ) to complete the string and initiate the desired operation. 


NOTE 

In correcting errors involving a source 
filename, it is necessary to respecify 
the file data mode. 


5.1.2 Operational Errors 


PIP also detects and reports errors found during the performance of 
the requested function. Parity errors, checksum errors, the inability 
of PIP to find a referenced filename, and protection code violations 
fall into this category. These errors are reported by PIP by messages 
output on the console teleprinter. The following is an example of an 
operational error: 


>T DK <GEP> EXANPP. 
FAPITY PPPGP 


\ 


SPC*~?P) 


- Command 


An error was detected on 
tap e 


the input 


PIP restarts itself after outputting the error message. 


5.2 PIP ERROR MESSAGES 


The messages output by PIP on the detection of command string or opera¬ 
tional errors are listed and described in Table 5-1. 
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5.3 CORRECTION AND RECOVERY COMMANDS 


If a user detects an error in the command string before it is terminated* 
he may 


a) delete the incorrect character* 

b} negate the line entered (prior to terminator) 
and restart on a new line. 


If an error is detected in the user 9 s command string by PIP* he may 


al respond to the PIP error report and command 
string printout by correctly completing the 
command; 

b) abort the task by entering a CTRL P or RETURN. 


The commands which permit the above procedures are listed and described 
in Table 5-2« 


TABLE 5“2 User Correction and Recovery Commands 

Which is Echoed on 

To i Types the Teleprinter ass 

1) Delete a character from RUBOUT \ 

the command string 

NOTEs Characters are deleted one per entry starting from 

the last entered character and proceeding to the left. 

2) Negate (delete) line CTRL U @ 

entered 


NOTEs The CTRL U entry must be made before the line is 
terminated - 

3) Abort the current task CTRL P fp 

and/or return control to or 

p I p RETURN Nonprinting 

NOTE: CTRL P entries are also requested by PIP during paper 

tape input and file segmentation operations to con¬ 
tinue operations after a tape or file segment has been 
transferred. 

4) Abort the current task CTRL C +C 

and/or return control to 

the monitor 

51 Continue the requested CTRL R +r 

operation after a "DEVICE 
NOT READY" condition has 
been corrected for a PDP-15 
device (not needed for a 
UC15 device). 
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SECTION 6 


QUICK REFERENCE TABLES 







6.1 INTRODUCTION 

This section contains tabularized data intended as an aid to recall 
for users who are familiar with the contents of Sections 2 and 3. 
Tables are supplied which describe the Primary PIP Operations, PIP 
Optional operations, optional functions permitted within each primary 
operation, and the PIP command structure, plus a series of tables de¬ 
scribing specific operations which may be carried out using PIP facil 
itieSo In some cases, the tables presented in this section are dupli 
cates of those contained in earlier sections of the manual? this 
redundancy is necessary to make this section a complete single source 
of information* 

6*2 OPTIONS VERSUS PRIMARY OPERATIONS 

The matrix Table 6-1 illustrates the optional PIP function switches 
permitted in each of the PIP primary operations* 

6.3 PIP COMMAND STRING FORMAT CHARTS 

Figure 6-2 illustrates the general format of the Destination/Source 
command strings; Figure 6-3 illustrates the general format of the 
Single-Device Command Strings* 

6.4 PXP USER OPERATION TABLES 

Tables 6-4, 6-5, 6-6, 6—7 and 6—8 describe the operations which may 
be performed by the standard user (UIC)? they contains 

a) a description of the operation, 

b) the optional switches which may be used, 

c) an example of a command string for each 
operation described. 

No attempt is made to describe all possible operation/switch combina¬ 
tions or applications. However, the user is provided with sufficient 
commands to meet his own requirements if he has familiarized himself 
with Sections 2 and 3 of this manual. 
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The User Operation Tables are organized according to the following 
functional areas: 


Table 

6-2 

6—3 

6-4 

6-5 

6-6 


Function Described 


Directory Operations , how to set up, list, modify, 
and operate with disk (UFD) and DECtape directories. 

List Operations , how to obtain printouts of direc¬ 
tory and file information. 

File Modification Operations , how to modify and 
manipulate files and file contents. 

File Transfer Operations , how to transfer files 
between system storage devices. 

Copy Operations , how to copy device contents, 
large groups of files or data blocks from system 
mass storage devices. 



TABLE 6-1 Available Options Versus Primary Operations 


PRIMARY OPERATIONS 



TRANSFER 

VERIFY 

SEGMENT 

LIST 

l 

o 

w 

& 

H 

Q 

is % 
W c 

53 E- 

DELETE FILE 

RENAME FILE 

COPY TAPE 

BLOCK COPY 

INITIALIZE 

UPDATE 


SWITCHES 

T 

V 

S 

L 

N 

D 

R 

c 

B 

i 2 

U 

DESCRIPTIONS 

CAl 

X 

X 










IOPS ASCII Data Mode 

CBl 

X 

X 










IOPS Binary Data Mode 

CCl 

X 











Space 4 to Tab Conversion 

CD) 

X 











Dump Mode 

Cel 

X 











Tab to Space Conversion 

(FI 

X 











Insert Form Feed 

CGI 

X 











Correct Bad Parity 

CH } 1 

X 







X 




Image Binary Mode 

CD 

X 











Image Alphanumeric Mode 

CN) 

X 







X 

X 



New Directory 

(Snn) 

X 




X 



X 

X 



New Directory with CTRL Q area 

CT) 

X 











Delete Trailing Spaces 

CQ) 

X 











Delete Sequence Numbers (cards) 

CW) 

a 







■1 

■ 

■ 

■ 

Combine Files 

(Y) 3 

a 








■ 

■ 

m 

Segment Files 

CK) 


i 

i 


X 

■ 

■ 





Delete Current UFD 

(M) 


\ 

X 








List Unprotected UFDs 

(X) 


i 



X 






Delete Truncated Files 

(P) 




X 




i 



List Current UFD & RIB data 

CL) 



1 

X 




\ i 

.i. 



List SYSBLK 


1 Legal only with DECtape or Disk Pack or Disk cartridge copy operations, 

2 Legal only when the current password is the MIC. 

3 Transfer, T, commands which include a Y option switch must be pre¬ 

ceded by an S, segment command string. 















DESTFL i—i SRC 


DTn 


T 1_1 DK 



DATA t _) SRC ) 


OPERATION 

COMMAND DESTINATION DESTINATION FILE OPTION SOURCE SOURCE FILE 

CHARACTER t—I DEVICE I — 1 (filename LJ ext) j I SWITCH(S)^ ^ DEVICE I | (filename ! | ext) TERMINATOR 


T - Transfer file 
L = List directory 
C = Copy mass 
storage 

R = Rename file 
B = Block copy 


Optional for non¬ 
file oriented de¬ 
vices. Use 
commas to sepa¬ 
rate multiple 
file names and 
extensions 


PP = Paper tape punch 
DTn= DECtape unit 
TT = Teletype 
LP = Line printer 
MTn= Magtape 
DK = DECdisk 
VP = VP15A CRT display 
DPn= Diskpack unit 
RKn= Disk cartridge unit 


Return 
control 
to PIP 
ALTMODE = 
Return 
control 
to the 

PR = Paper tape reader monitor 

TT = Teletype 

CD = Card reader 

DTn- DECtape unit 

MTn= Magtape unit 

DK = DECdisk 

DPn= Diskpack unit 

RKn= Disk cartridge unit 


Use commas to 
separate mul¬ 
tiple file 
names and ex¬ 
tensions . 


Data Mode Switches 


Function 


Switches 


A 

B 

I 

H 

D 


area. Size of area (nn) = 

8, 12, 16 , 20, 24, 2.8, or 32 
(K words) N operation only. 

Default = current size of 
system. 

F = Insert Form Feed every 55. n 

lines or after .EJECT 10 

T = Delete trailing spaces ”1 Input must be 

Q = Delete sequence numbersJ ^rd U £ormat 
M = Request a listing of 
the system MFD 

L = Request a listing of the 
system SYSBLK directory 
P = Request UFD listing with 
RIB data 


IOPS ASCII E - Convert tabs to spaces 

IOPS Binary G = Flag bad parity lines 

Image Alpha- c = Convert multiple spaces to 

numeric tabs 

Image Binary w = Combine files 

Dump Y = Segment files 

N = New Directory 

. Snn = New directorv with CTRL O 


Figure 6-2 Destination/Source Conunand String Format 
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DTI 


FILEA.FILES 


iAl ) 


c \ 




OPERATION 

COMMAND 


DEVICE 


FILE(S) INVOLVED 


OPTION 


TERMINATOR 



j 


N=new’ directory 
V=verify file 
D=delete 
I=initialize 
U=update 

Use commas to separate 
multiple filenames and 
extensions. 

3 ) —Return control 
to PIP 

ALT MODE = 
Return control 
to DOS 

Monitor 

PR=Paper Tape reader 

DTn=DECtape unit 


DPn-Diskpack unit 
MTn-Magtape unit 
RKn=Disk cartridge unit 


A = IOPS ASCII Data mode 
B = lOPS Binary Data Mode 
S = new directory with a core¬ 
sized iQAREA 

Snn = new directory with a 
user-specified sized 
tQAREA 

K = delete UFD 

X = delete all truncated files 


Figure 6-3 PIP Single Device Commands, General Format 
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IN ORDER TO USE OPERATION: AND OPTIONS: IN THIS MANNER 
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5) Copy and add files 
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APPENDIX A 


USE OF VT-15 GRAPHICS DISPLAY SYSTEM 









PIP users may employ the VT-15 display unit as either a listing or a 
general purpose display device. 

PROCEDURE 


a) Before PIP is loadedthe commands 

$vt u on) 

must be issued to the monitor to set up the display system for use. 

Bi Once PIP Is loaded, the user need only type CTRL X 

to activate the display function. For all practical purposes, 
the CTRL X (fX) command causes the VT Display to take the place 
of the console printer unit. Command characters entered at the 
console keyboard are echoed both by the console printer and on the 
VT Display screen; all other Information normally output to the 
printer ti.e., error messages, listings, etc.) is displayed on 
the VT display screen only. 

cl To discontinue the VT Display function, the user must issue a 
second CTRL X command. This action returns the display/print 
function to the console printer. The display unit, however, 
remains on and continues to display the information contained 
before the second CTRL X command was issued. 

dl To clear the VT-15 Display screen, the user must actuate the 
rightmost display control pushbutton (see CONTROLS) and enter 
a RETURN at the keyboard. 

el To turn the VT-15 Display off (i.e., deactivate the CTRL X 

feature), the user must return control to the monitor (CTRL C) 
and enter the commands 

$VT u pFF> 
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VT^15 CONTROLS AND DISPLAY MODES 


CONTROLS 

THe VT^15 Display console contains a horizontal strip of six square 
pusfi^toflight pushbuttons which are used in display operations. These 
pushbuttons are unmarked since their function is determined by software 
and may vary according to the particular program (system or user) which 
is in control of the system* 


In PIP operations f only the two rightmost pushbuttons are needed; these 
switches are referred to as #*s 5 and 6, based on the following number¬ 
ing schemes 


0 

2 

EJ 0 

5 6 


DISPLAY MODES 


The VT-15 Display operates in two display modes s 

SCROLL Mode - When the #5 pushbutton is in the ON 
(lit) position, the display is in the SCROLL mode* 

In this mode, when the display screen is full, the 
next line of data to be displayed causes the dis- 
played material to "roll" upwards, line-by-line, 
with new data displayed at the bottom of the screen. 

b) PAGE Mode - When the #5 pushbutton is in the OFF 
(unlit) position, the display is in the PAGE mode. 

In this mode, when the screen is full, the next 
entered material for display causes the complete, 
full-screen display (i*e*, PAGE) to be erased; the 
new material is then displayed starting at the top 
line of the screen* 

PAGING OPERATION 


When a large file is to be displayed in the Page mode, the #6 control 
pushbutton is used to advance the display through the file page (screen) 
ky page (screen!* Each time this pushbutton is actuated, the screen 
is cleared and the next set of data available is displayed. 
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APPENDIX B 


USE OF VP15A DISPLAY DEVICE 


In PDP-15 systems which have a VP15A Storage Tube Display, the PIP user 
may use the display device as a listing device. The PIP user may list 
system and device directories and files in the following manner: 

a) Listing Directories - System and device directories 
may be displayed on the VP15A by specifying the 
display r s device mnemonic (VP) as the destination 
device in an L, List,, command. For example, to 
cause the current UFD to be displayed in its most 
complete version, the user would issue the command: 

>L U VP-DK U (P)) 

bi Listing Files - The contents of files may be dis¬ 
played on the VP by specifying it as the destina¬ 
tion device in a T, Transfer, command. For example, 
to display the file TEST1 001 on the VP, the user 
would Issue the command: 

>T U VP-DK U TEST1 00l) 


DISPLAY CONTROLS 


The VP15A display unit is provided with two pushbutton controls, ERASE 
and VIEW which are located on the right front panel of the CRT enclosure. 

These controls are used in the following manner: 


a) ERASE When operated, it causes the current 

display to be erased from the display. 

b) VIEW The normal brightness of displayed data 

fades after 90 seconds unless renewed; 
this control enables the user to renew 
(brighten) the display when desired. 


WARNING 

The same display should not be maintained on the 
CRT for a period exceeding 15 minutes; if this 
occurs, the phosphor of the display CRT may be 
damaged. 
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DISPLAY MODES 


The VP15A CRT is capable of displaying fifty-six 72-character lines. 

If the data file to be displayed exceeds the 56—line display capacity, 
the display will operate in either a SCAN or PAGE mode depending on 
the type of handler installed in the system (VPA or VPA.S) for the 
VP15A 1 . 

SCAN Mode 


When the VPA device handler is installed in the operating system, the 
VP15A display operates in a SCAN mode. In this mode, each time the 
display screen is filled it is erased, automatically, after the 56th 
list is written and is refilled from the display file. This fill-erase- 
rewrite cycle is continued until the screen is completely or partially 
filled and no more data is in the file to be displayed. The last dis¬ 
play is not erased but remains and may be renewed (brightened) manually 
by trie viewer when necessary. 

PAGE Mode 

When the VPA.S handler is installed in the operation system, the VP15A 
Display operates in a PAGE mode. In this mode the erase-rewrite opera¬ 
tions of the display are controlled by the manual operation of the Ac¬ 
cumulator zero switch (ACSJ0) . Each time the display is filled, the 
full screen (i.e., page) is not erased and rewritten with the next set 
of available display file data if the ACSJ# switch is actuated. This 

feature permits the user to manually advance through a file page—by— 

page. 


1 The type of VP15A handler available in the operating system will be 
that selected by the System Manager during the configuration of the 
system. 
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APPENDIX C 


DOS TERMS AND ACRONYMS 




/"V 


y H 



Terms unique to the PDP-15 DOS Software System which are used in the 
PIP manual are listed and described in the following tablec The acro¬ 
nyms for each term are also given. Detailed descriptions of the items 
identified by the following terms are given in the DOS Software System 
Users Manual, DEC^IS-ODUMA-b-D* 


TERM 


Bad Allocation Table 


Master File Directory 


ACRONYM DEFINITION 

BAT A device (disk) table which in¬ 

dicates, in storage blocks, any 
faulty disk areas in which data 
cannot be stored,. 

MFD A master device (disk) file di¬ 

rectory which contains pointers 
to all user directories (UFD ! s) 
within a disk device. 


Monitor Identification Code MIC 


Storage Allocation Table SAT 


System Block SYSBLK 


User File Directory UFD 


User- File Directory Table UFDT 


User Identification Code UIC 


The master system password which 
permits full access to all files 
within the system. This code 
identifies the system manager 
and should be used only by him. 

The device (disk) table which 
stores busy, not-busy indicators 
for the disk storage area. 

The system table which contains 
the names, locations, and load¬ 
ing and starting parameters for 
all system programs within the 
operating system. 

File directories for each user 
who establishes disk file stor¬ 
age areas within the system. 

The system directory table which 
maintains the relationship be¬ 
tween the system f s .DAT slots 
and each unique user identifi¬ 
cation code (UIC). 

A password entered by a user to 
uniquely define himself and any 
files which he may enter. If 
necessary, a user may enter more 
than one UIC to establish sev¬ 
eral unique sets of files. Since 
only one user may employ the sys¬ 
tem at any one time, the current 
UIC is the last logged-in UIC. 


C-l 







APPENDIX D 


SYSTEM ERROR MESSAGES 


The system Input/Output Programming System, loaders, and Object Time 
System error messages are output at the console printer as an 
identifying acronym plus a numeric error code (i.e., IOPS47). The 
acronyms used are: 


al 

Input/Output Programming System 

IOPS 

b) 

Loaders 

*LOAD or 

c) 

Object Time System 

- OTS 


.SYSLD 


The numeric error codes and the meaning of each are as follows: 


DOS®|S » »I OPS 8 


0 ill function cal - cal addr 

1 CAL* ILL - CAL ADDR 

2 .OAT SLOT ERROR - CAL AppB 

3 ILL INTERRUPT - I/O STATUS REGISTER 

4 DEV NOT READ* - TYPE <“R WHEN READY * 

5 ILL .SETUP CAL - CAL aDQR 

6 ILL HANDLES FUNCTION - CAL ADqR * 

7 ILL DATA MODE « CAL AQDR & 

FILE STILL ACTIVE - CaL ADDS *« 

11 SEEK/ENTER NOT EXECUTED » CAL ADDR * 

12 UNRECOVERABLE DEVICE ERROR - STATUS REG 8 AND UNIT NO, 

13 FILE NOT FOUND « CAL ADOP ** 

h directory full • cal adds 

15 DEVICE full - CAL ADDR ** 

16 OUTPUT BUFFER OVERFLOW - CAL ADDR 

1? TOO many FILES for handler - CAL ADDR * 

20 disk FAILURE Car TO RETRY) - DISK STATUS # BL« #»DEVICI/UNIT S»CAL FUNC,UIC 

21 ILL DISK ADDR - BLOCK No,DEVleE/UNlT NO,CAL FUNCTION,UIC 

22 TWO OUTPUT FILES ON ONE DECT APE UNIT « CAL ADDR 

23 ILL WORD PAIR COUNT - CAL aodb ** 

25 NEGATIVE OR « CHARACTER COUNT (IOPS ASCII WRITE) 

X OR Y INCREMENT TOO L*RGF t>2**14) (BINARY WRITE) 

2/ ILLEGAL WRITE TYPE 

3(6 API SOFTWARE LEVEL ERROR . APT STATUS REG 

31 NON-EXISTENT MEMORY REF - PC 

32 MEMORY PROTECT VIOLATION . PC 

33 memory parity error » pc 

34 POWER FAIL skip not setup - Pc 
37 LINE OVFLO ® CAL ADDS 

40 HEADER LABEL ERROR - CAL ADDR 

41 DIRECTORY FORMAT ERROR - CAL ADDR 

42 ACCESSIBILITY MAP OVFlQ - CAL ADDR 

43 DIRECTORY RECORDING ERROR - CaL ADDR 

44 LOGICAL EOT FOUND - CaL ADOP 

45 LONG INPUT RECORD - CAL ADDR 

46 ATTEMPT TO DELETE SYSTEM FILE - CAL ADDR 

47 ILL HORIZONTAL TAB - C A L ADDR 

51 ILLEGAL USER FILE DIRECTORY - CAL ADDR ** 




55 NO BUFFERS AVAILABLE - CAL ADOR * 

61 PARITY ERROR IN DIRECTORY OR FILE BIT MAP • CAL ADDR * 

63 PROTECTED USER FILE DIRECTORY * CAL ADDR * 

64 PROTECTED FILE - CAL ADOR »* 

8S UNRECOVERABLE MAGTAPE Error - MT STATUS 

66 RELATIVE BLOCK IS B OR NOT WITHIN PILE SCOPE (.RTRAN) ** 

67 .RTRAN ARGUMENTS CAUSE DATA BLOCK OVERFLOW - CAL ADOR ** 

70 BUFFER SIZE TOO SMALL - CAL AODR * 

71 EMPTY UIC ** 

72 INPUT PARITY OR WRITE CHECK ERROR (aR TO RETRY) 

- CALADDR,BLOCK NO,OfVICE/UNlT NO,CAL FUNCTION,UIC 

73 NULL FILE NAME GIVEN QN SEEK/ENTER/DLETE/FSTAT/RAND * 

74 PILE STRUCTURE DEGRADATION . ATTEMPT TO CLEAR SUBMAP 
BIT THAT WAS ALREADY qFF ** 

75 FILE STRUCTURE DEGRADATION - ILLEGAL SUBMAP WORD 1 

76 FILE STRUCTURE DEGRADATION - ILLEGAL BACKWARD POINTER FOR FIRST 

MFD OR UFO BLOCK (*R TO RETRY'S 

77 ATTEMPTED USE OF NON-EXISTANT aQ AREA 

* DISK ONLY! 


CAL ADOR,DEVICE AND UNIT NO.,CAL FUNCTION,UIC 
** DISK ONLYI 

CAL ADDR,DEVICE AND UNIT NO.,CAL FUNCTION,UIC,FILE NAME 
LOADER ERRORS - .LOAD OR .SYSID 

1 MEMORY OVERFLOW 

2 DATA ERROR 

3 SUBR NOT FOUND 

4 .DAT SLOT ASSIGNMENT ERROR 

5 PROG SEGMENT GREATER THAN 4K {PAGE MODE) 

OBJECT TIME SYSTEM ERRORS - „OTS 

5 ILL REAL SQUARE ROOT A&G 

6 ill DOUBLE SQUARE ROOT ARG 

7 ILL INDEX IN COMPUTED GOTO 

10 ILL I/O DEV * 

11 ILL INPUT DATA 

12 ILL format STATEMENT 

13 ILL REAL LOG ARG 

14 ILL DOUBLE LOG ARG 

13 ZERO RAISED TO ZERO OR NEGATIVE POWER 

16 ATAN2C0.0,0,0) 

17 DATANg(0,000,0,000) 

21 undefined file 

22 ILLEGAL RECORD SIZE 

23 SIZE DISCREPANCY 

24 TOO MANY RECORDS OR ILLEGAL RECORD # 

23 MODE DISCREPANCY 

26 TOO MANY OPEN FILES 

30 SINGLE INTEGER OVERFLOW 

31 EXTENDED (DOUBLE) INTEGER OVERFLOW 

32 SINGLE FLT. OVERFLOW 

33 DOUBLE FlT. OVERFLOW 

34 SINGLE FlT. UNDERFLOW 

35 DOUBLE FLT, UNDERFLOW 
3b FLT, DIVIDE CHECK 

37 INTEGER DIVIDE CHECK 

40 ILLEGAL character count 

41 array exceeded 

42 bad Input data 

50 FPP MEMORY PROTECT/NON-EX 1STAnT MEMORY VIOLATION 
31 ILLEGAL I/O DIRECTION CHiNGF TO DISK 


D-2 



UC15 SYSTEM ERROR MESSAGES 


The Error messages from tasks running under PIREX have the following 
formati 




EST 

ESD 

IOPSUC RKU XXXX 

DTU 
LPU 
CDU 
PLU 
ESP 
EMA 


EST 

denotes 

ST 

(Stop all I/O) 

task 

ESD 

- 

SD 

(Software Driver) 

- 

RKU 

- 

RK 

(Disk Cartridge) 

- 

DTU 

- 

DT 

(DECtape) 

- 

LPU 


LP 

(Line Printer) 

- 

CDU 

- 

CD 

(Card Reader) 

- 

PLU 

- 

PL 

(Plotter) 

- 

ESP 

- 

SP 

(Spooler) 


EMA 


MA 

(MAC 11) 


XXXX 

denotes 

The low 

a 4-digit error code, 
order 2 digits are the task 

error codes 


while the high order 2 digits are the spooler 


task error codes (only for LP, CD and PL tasks). 

The following are the error codes for all the 
currently implemented tasks: 




LP 4 Not Ready 


CD 3 

4 

12 

45 

72 

74 

75 

76 

PL 4 

SP 4 

15 

77 


Illegal Interrupt to Driver 
Not Ready 
Device Failure 
Greater than 80 columns 
Illegal punch combinations 
Timing error, card column lost 
Hardware busy, driver not 
Hardware error between cards 

Not ready 

Spooler empty 
Spooler full 
Task not supported 
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INDEX 
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Acronyms, C-l 
Adding files, 3-40 

Angle brackets (<>), 2-6 

ASCII (A) switch, 2-11 


Back arrow («-) delimiter, 2-6 
Bank mode, 4-1 
B: block copy, 3-36 
Binary (B) switch, 2-11 


+ C, 1-2 

Card file modification, 3-25 
Card input, 3-25 
Ci copy mass storage, 3-39 
Characters, keyboard command, 1-3 
Characters, maximum number in 
command string, 2-1 
Checksum error correction, 3-20 
Colon (s) used as delimiter, 2-6 
Commands, 

destination source, 2-3, 2-4 
error correction, 5-7 
single device, 5-7 
Command string, 2-1 
delimiters, 2-6 
errors, 5-1 
Command types, 2-2 
Commas used in file transfer 
commands, 3-13 
Comma used as delimiter, 2-6 
Continuation lines, 2-1 
Copy operations, 6-14 
Create/initialize current UFD, 3-1 
CTRL C, 1-2 
CTRL D, 3-18 
CTRL P, 1-2 
CTRL Q area, 3-5 

(C) switch, space to tab 

conversion, 3-21, 3-22 

with card files, 3-26 


tD, 3-18 

Dash (-) used as delimiter, 2-6 
Data mode indicators, 2-12 
Data mode specification, 2-11, 

2- 12, 3-14 

Data mode switches, 2-13, 3-14 
D command, MIC, 4-2 
D t delete file, 3-31 

(D) Dump mode switch, 2-12 
DECtape directories initialization, 

3- 4 

DECtape file deletion, 3-34 
DECtape initialization, 3-5 
Definitions of DOS terms, C-l 


Deletion of 

DECtape files, 3-34 
files from UFD 5 s, 3-32 
truncated files, 3-34 
UFD's r 3-3 

Delimiters for command strings, 2-6 
Destination-source commands, 2-2 
format, 2-4, 6-4 
Device mnemonics, 2-7 
Devices, I/O and storage, 2-7 
Directory operations, 6-6 
Directory protection codes, 

2-13, 3-36 

Directory setup operation, 3-1 
Dump operations, 3-5 


Error messages 

PIP, 5-3 through 5-6 
system, D-l 
UC15 system, D-3 
Errors 

operational, 5-2 
recovery from, 5-7 
user command string, 5-1 

(E) switch, tab to space 
conversion, 3-21 
Extensions to filenames, 2-13 


File combination during transfer, 
3-23 

File modification operations, 6-10 
File names, 2-3 

extensions, 2-13, 3-14 
File protection codes, 2-14, 3-14 
setting, 3-36 
Files, truncated, 3-32 
File transfer, 3-12, 6-10 

between structured devices, 3-13 
device to device, 3-17 
keyboard to output devices, 3-18 
to disk, 3-15 
UFD to UFD, 3-16 
with optional functions, 3-20 
Functions of MIC, 4-1 
Functions, optional, 2-9, 2-10 
Function switches, 3-20 


Graphics display 
VP15A, B—1 
VT-15, A-l 

(G) switch. Parity/checksum error 
correction, 3-20 


(H) switch - Image Binary, 2-12 
in C command, 3-39 
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I command, MIC, 4-1 
Image Alphanumeric (I) switch, 
2-12 

Image Binary (H) switch, 2-12 
(I) switch - Image Alphanumeric, 
2-12 

Initialization, 3-1 
of DECtape, 3-5 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 
P• 0, BOX F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 

Questions or problems relating to Digital's software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 

Reading, England Milan, Italy 

Paris, France Solna, Sweden 

The Hague, Holland Geneva, Switzerland 

Tel Aviv, Israel Munich, West Germany 

Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 

Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 

Digital Equipment. Corporation Digital Equipment Corporation 

software Distribution Center Software Distribution Center 

146 Main Street 1400 Terra Bella 

Maynard, Massachusetts 01754 Mountain View, California 94043 

Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 

DECUS, Digital Equipment Computer Users Society, maintains a user ex¬ 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 

DECUS DECUS 

Digital Equipment Corporation Digital Equipment, S.A. 

146 Main Street P.O. Box 340 

Maynard, Massachusetts 01754 1211 Geneva 26 

Switzerland 
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